tag <tag string> command

The tag <tag string> command marks the current database state so you can roll back or deploy changes in the future.

Uses

The tag <tag string> command is typically used to mark the current database state by creating a new row in the DATABASECHANGELOG table. After setting the tag, you can use the updateToTag <tag> command to deploy all changes to this tag or the rollback <tag> command to roll back all changes under this tag.

The image below shows the DATABASECHANGELOG table structure. Running the command tag myTag creates a new entry in the DATABASECHANGELOG table—myTag.

If you run rollback myTag command, it will roll back only createTable с value. If you run updateToTag <tag> command, it will deploy createTable a and createTable b without deploying createTable с.

Note: It is best practice to tag your changesets before running any other commands against your database.

Running the tag <tag string> command

To run the tag <tag string> command, you need to specify your driver, class path, URL, and user authentication information in your liquibase.properties file. For more information, see Creating and configuring a liquibase.properties file. You can also specify these properties in your command line.

Then run the tag <tag string> command:

liquibase --changeLogFile=myChangelog.xml tag myTag

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

tag <tag string> global attributes

Attribute Definition Requirement

--changeLogFile

The root changelog

Required

--url

The JDBC database connection URL

Required

--username

The database username

Required

--password

The database password

Required

tag <tag string> command attributes

Attribute Definition Requirement

<tag>

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

Required