Merge branch 'master' of https://github.com/Datical/liquibase-docs

liquibase · Oct 28, 2024 · aaf4d25 · aaf4d25
2 parents dfec4bd + 1d67dc7
commit aaf4d25
Show file tree

Hide file tree

Showing 15 changed files with 79 additions and 67 deletions.
diff --git a/Content/Z_Resources/MainPages/Other-Topics-move-sidenav.flmsp b/Content/Z_Resources/MainPages/Other-Topics-move-sidenav.flmsp
@@ -1,13 +1,16 @@
 <?xml version="1.0" encoding="utf-8"?>
 <html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" MadCap:searchable="False">
     <head>
-		<!-- Google Tag Manager -->
-		<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
+        <!-- Google Tag Manager -->
+        <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
 			new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
 			j=d.createElement(s),dl=l!='dataLayer'?'&amp;l='+l:'';j.async=true;j.src=
 			'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
 		})(window,document,'script','dataLayer','GTM-P36W24N4');</script>
 		<!-- End Google Tag Manager -->
+		<!-- Context.ai bot -->
+		<script>(function(w,q,a){w[q]=w[q]||[];w[q].push=function(){(w[q].q=w[q].q||[]).push(arguments);};w[q].push('init',{agentId:a});var script=document.createElement('script');script.src='https://fullcontext.ai/embed.js';script.async=true;script.type='module';script.crossorigin='anonymous';document.head.appendChild(script);})(window,'fullContext','56f42b30-f962-4fde-b605-d094b6264baa');</script>
+		<!-- End Context.ai bot -->
         <!-- Prism Highlighting -->
         <script type="text/javascript" src="../Scripts/prism.js"> </script>
         <!-- End Prism Highlighting -->
@@ -17,17 +20,19 @@
         <link rel="stylesheet" href="../Stylesheets/GlideStyles.css" type="text/css" media="all" />
     </head>
     <body>
-		<!-- Google Tag Manager (noscript) -->
-		<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-P36W24N4" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
-		<!-- End Google Tag Manager (noscript) -->
-		<!-- Mutiny banners -->
-		<script>
+        <!-- Google Tag Manager (noscript) -->
+        <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-P36W24N4" height="0" width="0" style="display:none;visibility:hidden"></iframe>
+        </noscript>
+        <!-- End Google Tag Manager (noscript) -->
+        <!-- Mutiny banners -->
+        <script>
 			/* <![CDATA[ */
 			(function(){var a=window.mutiny=window.mutiny||{};if(!window.mutiny.client){a.client={_queue:{}};var b=["identify","trackConversion"];var c=[].concat(b,["defaultOptOut","optOut","optIn"]);var d=function factory(c){return function(){for(var d=arguments.length,e=new Array(d),f=0;f<d;f++){e[f]=arguments[f]}a.client._queue[c]=a.client._queue[c]||[];if(b.includes(c)){return new Promise(function(b,d){a.client._queue[c].push({args:e,resolve:b,reject:d})})}else{a.client._queue[c].push({args:e})}}};c.forEach(function(b){a.client[b]=d(b)})}})();
 			/* ]]> */
 		</script>
-		<script data-cfasync="false" src="https://client-registry.mutinycdn.com/personalize/client/9a74d33852d0d1db.js"></script>
-		<!-- End Mutiny banners -->
+        <script data-cfasync="false" src="https://client-registry.mutinycdn.com/personalize/client/9a74d33852d0d1db.js">
+        </script>
+        <!-- End Mutiny banners -->
         <MadCap:snippetBlock src="../Snippets/z_misc/searchbar-header.flsnp" />
         <MadCap:breadcrumbsProxy />
         <!--<div>  class="topic-layout"-->
@@ -64,7 +69,7 @@
         <!-- End Ratings -->
         <!-- End UserSnap Scripts -->
         <MadCap:snippetBlock src="../Snippets/z_misc/liquibase-footer.flsnp" />
-	<!-- Scarf.sh tracking pixel -->
+        <!-- Scarf.sh tracking pixel -->
         <img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=fc4516b5-fc01-40ce-849b-f97dd7be2a34" />
     </body>
 </html>
diff --git a/Content/Z_Resources/MainPages/Pro-Home-Page.flmsp b/Content/Z_Resources/MainPages/Pro-Home-Page.flmsp
@@ -1,21 +1,25 @@
 <?xml version="1.0" encoding="utf-8"?>
 <html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" MadCap:searchable="False">
-	<head>
-		<!-- Google Tag Manager -->
-		<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
+    <head>
+        <!-- Google Tag Manager -->
+        <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
 			new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
 			j=d.createElement(s),dl=l!='dataLayer'?'&amp;l='+l:'';j.async=true;j.src=
 			'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
 		})(window,document,'script','dataLayer','GTM-P36W24N4');</script>
-		<!-- End Google Tag Manager -->
-		<!-- Mutiny banners -->
-		<script>
+        <!-- End Google Tag Manager -->
+		<!-- Context.ai bot -->
+		<script>(function(w,q,a){w[q]=w[q]||[];w[q].push=function(){(w[q].q=w[q].q||[]).push(arguments);};w[q].push('init',{agentId:a});var script=document.createElement('script');script.src='https://fullcontext.ai/embed.js';script.async=true;script.type='module';script.crossorigin='anonymous';document.head.appendChild(script);})(window,'fullContext','56f42b30-f962-4fde-b605-d094b6264baa');</script>
+		<!-- End Context.ai bot -->
+        <!-- Mutiny banners -->
+        <script>
 			/* <![CDATA[ */
 			(function(){var a=window.mutiny=window.mutiny||{};if(!window.mutiny.client){a.client={_queue:{}};var b=["identify","trackConversion"];var c=[].concat(b,["defaultOptOut","optOut","optIn"]);var d=function factory(c){return function(){for(var d=arguments.length,e=new Array(d),f=0;f<d;f++){e[f]=arguments[f]}a.client._queue[c]=a.client._queue[c]||[];if(b.includes(c)){return new Promise(function(b,d){a.client._queue[c].push({args:e,resolve:b,reject:d})})}else{a.client._queue[c].push({args:e})}}};c.forEach(function(b){a.client[b]=d(b)})}})();
 			/* ]]> */
 		</script>
-		<script data-cfasync="false" src="https://client-registry.mutinycdn.com/personalize/client/9a74d33852d0d1db.js"></script>
-		<!-- End Mutiny banners -->
+        <script data-cfasync="false" src="https://client-registry.mutinycdn.com/personalize/client/9a74d33852d0d1db.js">
+        </script>
+        <!-- End Mutiny banners -->
         <!-- Prism Highlighting -->
         <script type="text/javascript" src="../Scripts/prism.js"> </script>
         <!-- End Prism Highlighting -->
@@ -24,14 +28,15 @@
         <!--End tabs for code examples -->
         <link rel="stylesheet" href="../Stylesheets/GlideStyles.css" type="text/css" media="all" />
     </head>
-	<body>
-		<!-- Google Tag Manager (noscript) -->
-		<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-P36W24N4" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
-		<!-- End Google Tag Manager (noscript) -->
-		<MadCap:bodyProxy />
-		<!-- UserSnap Scripts -->
-		<!-- Feedback Button -->
-		<script> <!--type="text/javascript"-->
+    <body>
+        <!-- Google Tag Manager (noscript) -->
+        <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-P36W24N4" height="0" width="0" style="display:none;visibility:hidden"></iframe>
+        </noscript>
+        <!-- End Google Tag Manager (noscript) -->
+        <MadCap:bodyProxy />
+        <!-- UserSnap Scripts -->
+        <!-- Feedback Button -->
+        <script> <!--type="text/javascript"-->
 			window.onUsersnapCXLoad = function(api) {
 			api.init();
 			}
@@ -40,10 +45,10 @@
 			script.src = 'https://widget.usersnap.com/global/load/632b7a0e-ba7b-4613-ab8a-a34d8edf1097?onload=onUsersnapCXLoad';
 			document.getElementsByTagName('head')[0].appendChild(script);
 		</script>
-		<!-- End Feedback Button -->
-		<!-- End UserSnap Scripts -->
+        <!-- End Feedback Button -->
+        <!-- End UserSnap Scripts -->
         <MadCap:snippetBlock src="../Snippets/z_misc/liquibase-footer.flsnp" />
-	<!-- Scarf.sh tracking pixel -->
+        <!-- Scarf.sh tracking pixel -->
         <img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=fc4516b5-fc01-40ce-849b-f97dd7be2a34" />
     </body>
 </html>
diff --git a/Content/Z_Resources/Snippets/def/attributes/change-types/change-type-associated-with.flsnp b/Content/Z_Resources/Snippets/def/attributes/change-types/change-type-associated-with.flsnp
@@ -1,8 +1,8 @@
-<?xml version="1.0" encoding="utf-8"?>
+<?xml version="1.0" encoding="utf-8"?>
 <html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" MadCap:searchable="False">
     <head>
     </head>
     <body>
-        <p>Specifies which columns to filter in the index you're creating. Some databases, like Oracle, automatically create indexes for primary key constraints and unique constraints, but not foreign key constraints. Use this <MadCap:variable name="General.Param/Attribute" /> to specify what your index associations are. Valid values: <code>primaryKey</code>, <code>foreignKey</code>, <code>uniqueConstriant</code>, <code>none</code>.</p>
+        <p>Specifies which columns to filter in the index you're creating. Some databases, like Oracle, automatically create indexes for primary key constraints and unique constraints, but not foreign key constraints. Use this <MadCap:variable name="General.Param/Attribute" /> to specify what your index associations are. Valid values: <code>primaryKey</code>, <code>foreignKey</code>, <code>uniqueConstraint</code>, <code>none</code>.</p>
     </body>
 </html>
diff --git a/Content/Z_Resources/Snippets/text/start-download-files.flsnp b/Content/Z_Resources/Snippets/text/start-download-files.flsnp
@@ -2,7 +2,7 @@
 <html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" MadCap:searchable="False">
     <body>
         <ul>
-            <li><MadCap:variable name="General.Liquibase" /> CLI: includes open-source and commercial functionality:<ul><li><code><a href="https://github.com/liquibase/liquibase/releases/latest/download/liquibase-4.29.2.tar.gz">liquibase-&lt;version&gt;.tar.gz</a></code>: archive in tar.gz format</li><li><code><a href="https://github.com/liquibase/liquibase/releases/latest/download/liquibase-4.29.2.zip">liquibase-&lt;version&gt;.zip</a></code>: archive in ZIP format</li><li><code><a href="https://github.com/liquibase/liquibase/releases/latest/download/liquibase-windows-x64-installer-4.29.2.exe">liquibase-windows-x64-installer-&lt;version&gt;.exe</a></code>: installer for Windows</li><li><code><a href="https://github.com/liquibase/liquibase/releases/latest/download/liquibase-macos-installer-4.29.2.dmg">liquibase-macos-installer-&lt;version&gt;.dmg</a></code>: installer for macOS<p class="note" MadCap:autonum="&lt;b&gt;Note: &lt;/b&gt;"><MadCap:variable name="General.Liquibase" /> will not support the MacOS .dmg installer by the end of October 2024. We recommend moving toward alternatives such as tarball or zip file installers.</p></li></ul></li>
+            <li><MadCap:variable name="General.Liquibase" /> CLI: includes open-source and commercial functionality:<ul><li><code><a href="https://github.com/liquibase/liquibase/releases/latest/download/liquibase-4.29.2.tar.gz">liquibase-&lt;version&gt;.tar.gz</a></code>: archive in tar.gz format</li><li><code><a href="https://github.com/liquibase/liquibase/releases/latest/download/liquibase-4.29.2.zip">liquibase-&lt;version&gt;.zip</a></code>: archive in ZIP format</li><li><code><a href="https://github.com/liquibase/liquibase/releases/latest/download/liquibase-windows-x64-installer-4.29.2.exe">liquibase-windows-x64-installer-&lt;version&gt;.exe</a></code>: installer for Windows</li></ul></li>
             <li>Primary libraries: for embedding in other software:<ul><li><code><a href="https://github.com/liquibase/liquibase/releases/latest/download/liquibase-core-4.29.2.jar">liquibase-core-&lt;version&gt;.jar</a></code>: base <MadCap:variable name="General.Liquibase" /> library (open source)</li><li><code><a href="https://github.com/liquibase/liquibase/releases/latest/download/liquibase-commercial-4.29.2.jar">liquibase-commerical-&lt;version&gt;.jar</a></code>: additional commercial functionality</li><p class="note" MadCap:autonum="&lt;b&gt;Note: &lt;/b&gt;"><code>liquibase-core-&lt;version&gt;.jar</code> contains only the open-source license. If you use <MadCap:variable name="General.LBPro" /> or other commercial add-ons, you must also install <code>liquibase-commercial-&lt;version&gt;.jar</code>.</p></ul></li>
             <li><code><a href="https://github.com/liquibase/liquibase/releases/latest/download/liquibase-additional-4.29.2.zip">liquibase-additional-&lt;version&gt;.zip</a></code>: contains additional, less commonly used files:<ul><li>Additional libraries such as <code>liquibase-maven-plugin.jar</code> and <code>liquibase-cdi.jar</code></li><li>Javadocs for all the libraries</li><li>Source archives for all the open source libraries</li><li>ASC/MD5/SHA1 verification hashes for all files</li></ul></li>
             <li><code><a href="https://github.com/liquibase/liquibase/releases/latest/download/liquibase-azure-deps-4.29.2.jar">liquibase-azure-deps-&lt;version&gt;.jar</a></code>: contains dependencies needed to use <MadCap:variable name="General.Liquibase" /> on <a href="../../../start/tutorials/ms-sql-server.html">Microsoft SQL Server</a> with Microsoft Azure SQL Managed Instance.</li>

diff --git a/Content/Z_Resources/Snippets/text/start-install-liquibase.flsnp b/Content/Z_Resources/Snippets/text/start-install-liquibase.flsnp
@@ -6,10 +6,9 @@
         <p>You can install <MadCap:variable name="General.Liquibase" /> on your <MadCap:conditionalText MadCap:conditions="start-install-liquibase.Windows">Windows</MadCap:conditionalText><MadCap:conditionalText MadCap:conditions="start-install-liquibase.MacOS">macOS</MadCap:conditionalText><MadCap:conditionalText MadCap:conditions="start-install-liquibase.Linux">Linux</MadCap:conditionalText> machine by following the steps on this page.</p>
         <p>Java is required to use <MadCap:variable name="General.Liquibase" />. If you use the <MadCap:variable name="General.Liquibase" /> Installer, Java is included automatically.</p>
         <p class="tip" MadCap:conditions="start-install-liquibase.Linux" MadCap:autonum="&lt;b&gt;Tip: &lt;/b&gt;">To install <MadCap:variable name="General.Liquibase" /> on a Linux machine using the Debian/Ubuntu package installer, see <MadCap:xref href="../../../start/install/liquibase-linux-debian-ubuntu.htm">Install [%=General.Liquibase%] on Linux with Debian/Ubuntu</MadCap:xref>. For the Red Hat/CentOS package manager, see <MadCap:xref href="../../../start/install/liquibase-linux-redhat-centos.htm">Install [%=General.Liquibase%] on Linux with Red Hat/CentOS</MadCap:xref>.</p>
-        <h2 MadCap:conditions="start-install-liquibase.MacOS,start-install-liquibase.Windows">Automatic</h2>
+        <h2 MadCap:conditions="start-install-liquibase.Windows">Automatic</h2>
         <p MadCap:conditions="start-install-liquibase.Windows">Click <a href="https://www.liquibase.com/download">Install <MadCap:variable name="General.Liquibase" /></a>.</p>
-        <p MadCap:conditions="start-install-liquibase.MacOS">Click <a href="https://www.liquibase.com/download">Install <MadCap:variable name="General.Liquibase" /></a>.</p>
-        <p MadCap:conditions="start-install-liquibase.MacOS,start-install-liquibase.Windows">If the <MadCap:variable name="General.Liquibase" /> Installer does not start automatically after downloading, locate the Installer file in your <code>Downloads</code> directory and run it.</p>
+        <p MadCap:conditions="start-install-liquibase.Windows">If the <MadCap:variable name="General.Liquibase" /> Installer does not start automatically after downloading, locate the Installer file in your <code>Downloads</code> directory and run it.</p>
         <p MadCap:conditions="start-install-liquibase.Windows">If Windows security prevents the <MadCap:variable name="General.Liquibase" /> Installer from running, click <b>Run Anyway</b>. Depending on your version of Windows, you might need to click <b>More info</b> first.</p>
         <h2 MadCap:conditions="start-install-liquibase.MacOS">Homebrew</h2>
         <p MadCap:conditions="start-install-liquibase.MacOS">To install <MadCap:variable name="General.Liquibase" /> with the <a href="https://docs.brew.sh/">Homebrew</a> package manager, follow these steps:</p>

diff --git a/Content/change-types/create-index.html b/Content/change-types/create-index.html
@@ -10,7 +10,7 @@ <h1 id="change-createindex">createIndex</h1>
         <p>The <code>createIndex</code> <MadCap:variable name="General.changetypes" /> creates an index on an existing column or a set of columns.</p>
         <h2>Uses</h2>
         <p>You can typically use the <code>createIndex</code> <MadCap:variable name="General.changetypes" /> when you want to add an index on one of the columns or a set of columns to increase the searchability of the records in your database.</p>
-        <p> If you set the <code>clustered</code> <MadCap:variable name="General.Param/Attribute" /> to <code>true</code>, <MadCap:variable name="General.Liquibase" /> will create a clustered index, which defines the order in which records are stored in a table. If you set the <code>clustered</code> <MadCap:variable name="General.Param/Attribute" /> to <code>false</code>, <MadCap:variable name="General.Liquibase" /> will create a non-clustered index, where the order of the rows will not match the order of the actual records.</p>
+        <p>If you set the <code>clustered</code> <MadCap:variable name="General.Param/Attribute" /> to <code>true</code>, <MadCap:variable name="General.Liquibase" /> will create a clustered index, which defines the order in which records are stored in a table. If you set the <code>clustered</code> <MadCap:variable name="General.Param/Attribute" /> to <code>false</code>, <MadCap:variable name="General.Liquibase" /> will create a non-clustered index, where the order of the rows will not match the order of the actual records.</p>
         <p>When creating indexes, <MadCap:variable name="General.Liquibase" /> uses the order of columns that you list in the <code>createIndex</code> <MadCap:variable name="General.changetypes" />. For example:</p><pre xml:space="preserve"><code class="language-xml">&lt;changeSet author="bob" id="1_createTable_department"&gt;
    &lt;createTable tableName="department"&gt;
       &lt;column name="col_1" type="integer"/&gt;

diff --git a/Content/commands/inspection/diff-changelog.html b/Content/commands/inspection/diff-changelog.html
@@ -10,12 +10,13 @@ <h1 id="liquibase-commands-diff-changelog"><code>diff-changelog</code>
         </h1>
         <p>The <code class="language-text">diff-changelog</code> command displays the differences between two databases you are comparing. It also generates a <MadCap:variable name="General.changelog" /> file containing deployable <MadCap:variable name="General.changeset" />s to resolve most of these differences.</p>
         <h2 id="uses">Uses</h2>
-        <p>The <code class="language-text">diff-changelog</code> command is typically used when you want to create a deployable <MadCap:variable name="General.changelog" /> to synchronize multiple databases. The <code class="language-text">diff-changelog</code> command also provides more information about:</p>
+        <p>The <code class="language-text">diff-changelog</code> command is typically used when you want to create a deployable <MadCap:variable name="General.changelog" /> to synchronize multiple databases. The <code class="language-text">diff-changelog</code> command also provides more information about <a href="../../workflows/liquibase-community/drift-detection.html">database drift</a>:</p>
         <ul>
             <li>Missing objects in your database</li>
             <li>Changes made to your database</li>
             <li>Unexpected items in your database</li>
         </ul>
+        <p>In <MadCap:variable name="General.LBPro" /> 4.25.1 and later, you can use <code class="language-text">diff-changelog</code> to seamlessly generate a <MadCap:xref href="../../liquibase-pro/observability/operation-reports-drift-report.htm">Drift Report</MadCap:xref> for your databases.</p>
         <h2 id="running-the-diff-changelog-command">Running the <code>diff-changelog</code> command</h2>
         <MadCap:snippetBlock src="../../Z_Resources/Snippets/text/command-diff-run.flsnp" MadCap:conditionTagExpression="include[command-diff-run.diff-changelog]" />
         <h2 id="output">Output</h2>