Maven rollbackOneUpdateSQL
Last updated: July 14, 2025
The Maven rollbackOneUpdateSQL goal is a helper goal that allows you to inspect the SQL Liquibase will run to revert all changesets associated with the deploymentID specified when using the Maven rollbackOneUpdate goal.
Note: This is a Liquibase Pro goal, so you need a Liquibase Pro license key to use it.
Uses
The rollbackOneUpdateSQL
goal is typically used when you want to inspect the raw SQL that Liquibase uses to revert all changesets associated with a specified deploymentId
when you run the rollbackOneUpdate
command, so you don't unintentionally make a mistake.
Maven configuration
You can configure Liquibase Maven in multiple ways. You can pass arguments like <changeLogFile>
in Maven directly in your pom.xml
file, in a liquibase.properties
file referenced in your POM, as environment variables, or as JVM system properties. To learn about each file's syntax, see Maven Properties.
Tip: For more information about the Maven configuration, see Configuring Maven.
Ensure you add <ProLicenseKey>specify your Liquibase Pro license key here</ProLicenseKey>
to pom.xml
or specify it in another valid way.
Running the rollbackOneUpdateSQL Maven goal
Before running the rollbackOneUpdateSQL
goal, you can get the deploymentId
of the deployment you want to revert by running the Maven history goal: mvn liquibase:history
Note: If you don't specify the deploymentId
, by default, Liquibase Pro will look up the most recent deploymentId
from the DATABASECHANGELOG table and use it for the rollback.
Next, run the rollbackOneUpdateSQL
goal, with your information:
mvn liquibase:rollbackOneUpdateSQL -Dliquibase.deploymentId=6408658154
Note: Enter the name of the deploymentId
that you want to use in place of 6408658154
. For more information, run mvn liquibase:help -Ddetail=true -Dgoal=rollbackOneUpdateSQL
.
Maven rollbackOneUpdateSQL
Required Maven rollbackOneUpdateSQL configuration attributes
Attribute | Definition |
---|---|
| Specifies the update your want to roll back. A list of updates with changesets grouped by their |
| Specifies a required flag that indicates you intend to run this command. |
| Specifies your Liquibase Pro license key. |
Maven rollbackOneUpdateSQL output
Starting Liquibase at 11:07:15 (version 4.1.1 #10 built at 2020-10-12 19:24+0000)
[INFO] Parsing Liquibase Properties File local.liquibase.properties for changeLog parameters
[INFO] Executing on Database: jdbc:oracle:thin:@localhost:1521/ORCL
[INFO] Successfully installed license from Base64 string starting with 'ABwwGgQUvH' (property liquibaseProLicenseKey).
[INFO] Liquibase Pro 4.1.1 by Liquibase licensed to support until Wed Sep 22 23:59:59 CDT 2021
[INFO] Liquibase Pro 4.1.1 by Liquibase licensed to support until Wed Sep 22 23:59:59 CDT 2021
[INFO] Reading from DATABASECHANGELOG
[INFO] Successfully acquired change log lock
[INFO] Successfully released change log lock
-- *********************************************************************
--rollback deployment ID '6408658154'
-- *********************************************************************
-- Change Log: dbchangelog.xml
-- Ran at: 11/27/20 11:07 AM
-- Against: MVN_UAT@jdbc:oracle:thin:@localhost:1521/ORCL
-- Liquibase version: 4.1.1
-- *********************************************************************
-- Lock Database
UPDATE DATABASECHANGELOGLOCK SET LOCKED = 1, LOCKEDBY = 'WIN-20E107KB4TN (172.30.3.88)', LOCKGRANTED = TO_TIMESTAMP('2020-11-27 11:07:17.272', 'YYYY-MM-DD HH24:MI:SS.FF') WHERE ID = 1 AND LOCKED = 0;
-- Rolling Back ChangeSet: dbchangelog.xml::1606322157619-15::Nataliya (generated)
DROP TABLE 23;
DELETE FROM DATABASECHANGELOG WHERE ID = '1606322157619-15' AND AUTHOR = 'Nataliya (generated)' AND FILENAME = 'dbchangelog.xml';
-- Rolling Back ChangeSet: dbchangelog.xml::1606322157619-14::Nataliya (generated)
DROP TABLE 33;
DELETE FROM DATABASECHANGELOG WHERE ID = '1606322157619-14' AND AUTHOR = 'Nataliya (generated)' AND FILENAME = 'dbchangelog.xml';
-- Rolling Back ChangeSet: dbchangelog.xml::1606322157619-2::Nataliya (generated)
DROP TABLE 2;
DELETE FROM DATABASECHANGELOG WHERE ID = '1606322157619-2' AND AUTHOR = 'Nataliya (generated)' AND FILENAME = 'dbchangelog.xml';
-- Rolling Back ChangeSet: dbchangelog.xml::1606322157619-12::Nataliya (generated)
DROP TABLE 3;
DELETE FROM DATABASECHANGELOG WHERE ID = '1606322157619-12' AND AUTHOR = 'Nataliya (generated)' AND FILENAME = 'dbchangelog.xml';
-- Release Database Lock
UPDATE DATABASECHANGELOGLOCK SET LOCKED = 0, LOCKEDBY = NULL, LOCKGRANTED = NULL WHERE ID = 1;
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 4.695 s
[INFO] Finished at: 2020-11-27T11:07:17-06:00
[INFO] ------------------------------------------------------------------------