Connect Liquibase with Oracle Autonomous Database with ATP & ADW

Last updated: November 18, 2025

Oracle Autonomous Database is an Oracle Cloud product with services that deliver automated patching, upgrades, and tuning. It includes:

  • Autonomous Transaction Processing (ATP) – an Autonomous Database service that can instantly scale to meet the demands of mission-critical transaction processing and mixed workload applications.

  • Autonomous Data Warehouse (ADW) – a fully autonomous data warehousing environment that scales elastically, delivers fast query performance, and requires no database administration.

For more information, see the Oracle Cloud documentation page.

Verified database versions

19c

Before you begin

Procedure

1

(Maven users only) Configure Maven

If you're running Liquibase using the Maven plugin using mvn liquibase:update installing the extension with Maven ensures the right files are available and everything works together automatically. You can manage these extensions by adding them as dependencies in your project’s pom.xml file. When configured this way, Maven automatically downloads the specified JAR files from Maven Central during the build process.

2

Configure your connection

1. Log into your Oracle Cloud account.

2. Navigate to Autonomous Database and select DB Connection > Wallet Type > Download.

3. Enter a secure password for the Wallet and download the ZIP file to save the client security credentials.

4. Unzip the Wallet and place it somewhere safe in your file system to prevent unauthorized database access.

5. Navigate to the Wallet folder and update the ojdbc.properties file with the following:

  • Comment out the oracle.net.wallet_location line.

  • Set javax.net.ssl.trustStorePassword to the Wallet password that you entered to download the Wallet.

  • Set javax.net.ssl.keyStorePassword to the Wallet password that you entered to download the Wallet.

#oracle.net.wallet_location=(SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=${TNS_ADMIN}))) javax.net.ssl.trustStore=${TNS_ADMIN}/truststore.jks javax.net.ssl.trustStorePassword=my_wallet_password javax.net.ssl.keyStore=${TNS_ADMIN}/keystore.jks javax.net.ssl.keyStorePassword=my_wallet_password

6. In the Wallet folder, open the sqlnet.ora and ensure that SSL_SERVER_DN_MATCH=yes.

7. Specify the database URL in the liquibase.properties file (defaults file), along with other properties you want to set a default value for. Liquibase does not parse the URL. You can either specify the full database connection string or specify the URL using your database's standard connection format:

url: jdbc:oracle:thin:@<database_name>_high?TNS_ADMIN=/path/to/Wallet_<database_name>

Note: If you use Windows, ensure the TNS_ADMIN path to your wallet folder includes double slashes in the URL property.

Example: url: jdbc:oracle:thin:@databaseName_high?TNS_ADMIN=path//to//Wallet_databaseName

To apply a Liquibase Secure key to your project, add the following property to the Liquibase properties file: licenseKey: <paste code here>

3

Test your connection

1. Create a text file called changelog (.sql, .yaml, .json, or .xml) in your project directory and add a changeset.

If you already created a changelog using the init project command, you can use that instead of creating a new file. When adding onto an existing changelog, be sure to only add the changeset and to not duplicate the changelog header.

loading

loading

loading

loading

2. Navigate to your project folder in the CLI and run the Liquibase status command to see whether the connection is successful:

liquibase status

Note: You can specify arguments in the CLI or keep them in the Liquibase properties file.

If your connection is successful, you'll see a message like this:

4 changesets have not been applied to <your_connection_url> Liquibase command 'status' was executed successfully.

3. Inspect the deployment SQL with the update-sql command

liquibase update-sql

If the SQL that Liquibase generates isn't what you expect, you should review your changelog file and make any necessary adjustments.

4. Then execute these changes to your database with the update command:

liquibase update

If your update is successful, Liquibase runs each changeset and displays a summary message ending with:

Liquibase: Update has been successful. Liquibase command 'update' was executed successfully.

5. Verify that the database contains your test_table and the DATABASECHANGELOG, and DATABASECHANGELOGLOCK tables.

Supported Change Types & commands

Change Type

Supported

addAutoIncrement

Not Supported

addCheckConstraint

Supported

addColumn

Supported

addDefaultValue

Supported

addForeignKeyConstraint

Supported

addLookupTable

Supported

addNotNullConstraint

Supported

addPrimaryKey

Supported

addUniqueConstraint

Supported

alterSequence

Supported

createFunction

Supported

createIndex

Supported

createPackage

Supported

createPackageBody

Supported

createProcedure

Supported

createSequence

Supported

createSynonym

Supported

createTable

Supported

createTrigger

Supported

createView

Supported

customChange

Supported

delete

Supported

disableCheckConstraint

Supported

disableTrigger

Supported

dropAllForeignKeyConstraints

Supported

dropCheckConstraint

Supported

dropColumn

Supported

dropDefaultValue

Supported

dropForeignKeyConstraint

Supported

dropFunction

Supported

dropIndex

Supported

dropNotNullConstraint

Supported

dropPackage

Supported

dropPackageBody

Supported

dropPrimaryKey

Supported

dropProcedure

Supported

dropSequence

Supported

dropSynonym

Supported

dropTable

Supported

dropTrigger

Supported

dropUniqueConstraint

Supported

dropView

Supported

enableCheckConstraint

Supported

enableTrigger

Supported

executeCommand

Supported

insert

Supported

loadData

Supported

loadUpdateData

Supported

markUnused

Supported

mergeColumns

Supported

modifyDataType

Supported

output

Supported

renameColumn

Supported

renameSequence

Supported

renameTable

Supported

renameTrigger

Supported

renameView

Supported

setColumnRemarks

Supported

setTableRemarks

Supported

sql

Supported

sqlFile

Supported

stop

Supported

tagDatabase

Supported

update

Supported

Command

Supported

calculate-checksum

Supported

changelog-sync

Supported

changelog-sync-sql

Supported

changelog-sync-to-tag

Supported

changelog-sync-to-tag-sql

Supported

clear-checksums

Supported

db-doc

Supported

diff

Supported

diff JSON

Supported

diff-changelog

Supported

drop-all

Supported

future-rollback-count-sql

Supported

future-rollback-from-tag-sql

Supported

future-rollback-sql

Supported

generate-changelog

Supported

help

Supported

history

Supported

list-locks

Supported

mark-next-changeset-ran

Supported

mark-next-changeset-ran-sql

Supported

release-locks

Supported

rollback

Supported

rollback-count

Supported

rollback-count-sql

Supported

rollback-one-changeset

Supported

rollback-one-changeset-sql

Supported

rollback-one-update

Supported

rollback-one-update-sql

Supported

rollback-sql

Supported

rollback-to-date

Supported

rollback-to-date-sql

Supported

snapshot

Supported

snapshot-reference

Supported

status

Supported

tag

Supported

tag-exists

Supported

unexpected-changesets

Supported

update

Supported

update-sql

Supported

update-count

Supported

update-count-sql

Supported

update-testing-rollback

Supported

update-to-tag

Supported

update-to-tag-sql

Supported

validate

Supported