tag <tag string> command

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

Uses

The tag <tag string> command is typically used to mark the current database state, version, release, or any other information by adding the tag to the last row in the DATABASECHANGELOG table. After setting the tag, you can use the rollback <tag> command to roll back all changes under this tag.

The image below shows the DATABASECHANGELOG table structure. Running the command tag version1 applies the tag version1 to the last row in the DATABASECHANGELOG table. If you run rollback version1 command, it will roll back only createTable C value.

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, and URL 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 version1

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

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