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