changelogSyncToTagSQL command

changelogSyncToTagSQL is a helper command that produces the raw SQL that Liquibase would run when using the changelogSyncToTag command to mark all undeployed changesets associated with the specified tag as executed in your database.


The changelogSyncToTagSQL command is typically used when you want to inspect the SQL Liquibase will use to baseline a new database environment.

It is best practice to inspect any SQL that Liquibase would run when using the changelogSyncToTag command so you can review any changes the command would make to your database before running it. The changelogSyncToTag command marks all changesets starting with the first changeset at the top of the changelog file and moving down to the changeset up to and including the tag.

Note: If you don’t have any tag specified in your changelog file, add it by using the tagDatabase Change Type as follows:

<changeSet id="13.1" author="liquibase">
<tagDatabase tag="version_2.0"/>

Running the changelogSyncToTagSQL command

Before running the changelogSyncToTagSQL command, you can specify the driver, classpath, and URL in your file. For more information, see Creating and configuring a file. You can also specify these properties in your command line.

Next, run the changelogSyncToTagSQL command:

liquibase --changelogFile=mychangelog.xml changelogSyncToTagSQL version1

Note: Enter the name of the changelog and the tag that you want to use in place of mychangelog.xml and version1.

changelogSyncToTagSQL global attributes

Attribute Definition Requirements
--changeLogFile The root changelog Required
--url The JDBC database connection URL Required
--username The database username Required
--password The database password Required
--outputFile* Specifies the file path to where the changelogSyncToTag SQL will be written Optional

*If not specified, the changelogSyncToTagSQL output goes to STDOUT.

changelogSyncToTagSQL command attributes

Attribute Definition Requirements
tag The tag you can add to changesets to determine which changesets in the changelog to evaluate based on their tags. Required