What databases are supported by Liquibase?

Liquibase works with 60+ databases, including relational, NoSQL, and graph databases.

Learn more about using Liquibase with your favorite databases with our in-depth tutorials. These tutorials explain how to install and configure your database with Liquibase Open Source and Liquibase Secure.

Liquibase-maintained databases

Liquibase tests with English language databases only. Other languages with special characters may cause issues.

The following table shows databases whose compatibility with Liquibase is maintained by Liquibase. For databases maintained by the community, see the "Community-maintained databases" section.

Note: Many databases are based on similar underlying architectures and use similar JDBC connection information. The "Database" column refers to your front-end database implementation. The "DBMS/shortname" field refers to the back-end system that Liquibase recognizes in JDBC URLs and in the dbms changeset attribute.

Database

Verified versions

Shortname / Driver / Notes

Amazon DocumentDB

4.0

DBMS/shortname: mongodb

File: mongo-java-driver-<version>.jar

JDBC URL: jdbc:mongodb://localhost:27069/lbcat?tls=false&retryWrites=false

Download: Maven: com/mongodb/mongo-java-driver

Extension: GitHub: liquibase/liquibase-mongodb

Notes: Amazon DocumentDB emulates MongoDB. Connect via the MongoDB Secure extension. For TLS/SSL configuration, see the Amazon DocumentDB tutorial page.

Amazon DynamoDB

Cloud

DBMS/shortname: dynamodb

File: liquibase-commercial-dynamodb

Connection URL: https://dynamodb.<region>.amazonaws.com or dynamodb://localhost:8000

Download: Maven: liquibase-commercial-dynamodb

Amazon Redshift

Cloud

DBMS/shortname: redshift

File: redshift-jdbc<version>.jar

Class: com.amazon.redshift.jdbc42.Driver

JDBC URL: jdbc:redshift://endpoint:port/dbname

Download: AWS: Download the Amazon Redshift JDBC driver, version 2.1

Apache Cassandra

2.1+

DBMS/shortname: cassandra

File: Cassandra uses the DataStax Java Driver rather than a traditional JDBC driver. The primary options are: java-driver-core-<version>.jar (DataStax Java Driver 4.x) cassandra-jdbc-wrapper-<version>.jar (if using a JDBC wrapper)

Class: -DataStax Driver: com.datastax.oss.driver.api.core.CqlSession (not a JDBC driver) - JDBC Wrapper (if applicable): com.ing.data.cassandra.jdbc.CassandraDriver

JDBC URL: - JDBC Wrapper format: jdbc:cassandra://host:port/keyspace -Native CQL format: cassandra://host:port (varies by implementation)

Download: DataStax Java Driver: DataStax Java Driver Downloads Maven Central: Search for java-driver-core or cassandra-jdbc-wrapper

Apache Cassandra on DataStax Astra DB

5.0+

DBMS/shortname: cassandra (Astra uses the same Cassandra driver)

File:

- java-driver-core-<version>.jar (DataStax Java Driver 4.x)

- java-driver-query-builder-<version>.jar (often needed)

Class: com.datastax.oss.driver.api.core.CqlSession

JDBC URL/Connection: Astra doesn't use a traditional JDBC URL. Instead, it uses:

Secure Connect Bundle: astra-secure-connect-<database-name>.zip Connection format: Configuration-based using the secure bundle path

Download: DataStax Java Driver: DataStax Java Driver for Apache Cassandra Secure Connect Bundle: Download from Astra DB console for your specific database Maven Central: Search for java-driver-core (group ID: com.datastax.oss)

Amazon Keyspaces for Apache Cassandra

3.11.2

DBMS/shortname: cassandra (Keyspaces uses the same Cassandra driver)

File: java-driver-core-<version>.jar (DataStax Java Driver 4.x) aws-sigv4-auth-cassandra-java-driver-plugin-<version>.jar (AWS SigV4 authentication plugin)

Class: com.datastax.oss.driver.api.core.CqlSession

JDBC URL/Connection: Endpoint: cassandra.{region}.amazonaws.com:9142 Format: Connection configured programmatically with AWS-specific settings Example endpoint: cassandra.us-east-1.amazonaws.com:9142

Download: DataStax Java Driver: DataStax Java Driver for Apache Cassandra AWS SigV4 Plugin: Amazon Keyspaces SigV4 Plugin or Maven Central Maven Central: Search for java-driver-core and aws-sigv4-auth-cassandra-java-driver-plugin

Additional Requirements: SSL/TLS Certificate: Amazon root CA certificate (AmazonRootCA1.pem) Authentication: AWS IAM credentials or service-specific credentials Port: 9142 (TLS-enabled port) Region-specific endpoint: Must specify the AWS region where your keyspace exists

Notes: Keyspaces requires TLS encryption for all connections Authentication uses AWS SigV4 signing process (requires the AWS plugin) Connection timeout and consistency settings may need adjustment for Keyspaces

AWS Aurora – MySQL

8.0 5.7

DBMS/shortname: mysql

File: mysql-connector-java-<version>.jar

Class: N/A

JDBC URL: jdbc:mysql://<endpoint>:<port>/<dbname>

Download: Amazon Aurora

AWS Aurora for PostgreSQL

17 16 15 14 13 12 11

DBMS/shortname: postgresql

File: postgresql-<version>.jar

Class: com.postgresql.Driver

JDBC URL: jdbc:postgresql://<instance_host>:<instance_port>/<dbname>

Download: Amazon Aurora

AWS RDS – MariaDB

11.4 (LTS) 10.6 (LTS)

DBMS/shortname: mariadb

File: mariadb-java-client-<version>.jar

Class: com.mariadb.jdbc.Driver

JDBC URL: jdbc:mariadb://<endpoint>:<port>/<dbname>

Download: Amazon RDS for MariaDB

AWS RDS – Microsoft SQL Server

2019 2017 2016 2014 (deprecated)

DBMS/shortname: mssql

File: mssql-jdbc-<version>.jre-<version>.jar

Class: com.microsoft.sqlserver.jdbc.SQLServerDriver

JDBC URL: jdbc:sqlserver://<endpoint>:<port>/<dbname>;

Download: Amazon RDS for SQL Server

Notes: Requires semicolon at end.

AWS RDS – MySQL

8.0 5.7

DBMS/shortname: mysql

File: mysql-connector-java-<version>.jar

Class: N/A JDBC URL: jdbc:mysql://<endpoint>:<port>/<dbname>

Download: Amazon RDS for MySQL

AWS RDS – Oracle Database

21c 19c

DBMS/shortname: oracle

File: ojdbc<version>.jar

Class: oracle.jdbc.OracleDriver

JDBC URL: jdbc:oracle:thin:@<endpoint>:<port>:<sid> Download: Amazon RDS for Oracle

AWS RDS – PostgreSQL

17 16 15 14 13 12 (deprecated)

DBMS/shortname: postgresql

File: postgresql-<version>.jar

Class: com.postgresql.Driver

JDBC URL: jdbc:postgresql://<instance_host>:<instance_port>/<dbname>

Download: Amazon RDS for PostgreSQL

Azure Database for MySQL

8.0 5.7

DBMS/shortname: mysql

File: mysql-connector-java-<version>.jar

Class: N/A JDBC URL: jdbc:mysql://<endpoint>:<port>/<dbname>

Download: Azure Database for MySQL

Azure Database – Postresql – Flexible Server

16 15 13

DBMS/shortname: postgresql

File: postgresql-<version>.jar Class: com.postgresql.Driver

JDBC URL: jdbc:postgresql://<endpoint>:<port>/<dbname>

Download: Azure Database for PostgreSQL – Flexible Server

Databricks SQL

Cloud AWS Azure Google cloud platforms

DBMS/shortname: databricks

File: liquibase-databricks

JDBC URL: jdbc:databricks://<your_workspace_host_name>:443/default;AuthMech=3;httpPath=/sql/1.0/warehouses/<your_warehouse_id>;ConnCatalog=<your_catalog>;ConnSchema=<your_schema>;

Download (Community): GitHub: liquibase/liquibase-databricks Download (Secure): Maven Central: liquibase-commercial-databricks

EnterpriseDB

16 15 14 13 12 (deprecated)

DBMS/shortname: edb

File: edb-jdbc-<version>.jar

Class: com.edb.Driver

JDBC URL: jdbc:edb://<hostname>:5444/<dbname>

Download: EnterpriseDB: Downloads: EDB Connectors

Google BigQuery

2.13.6+

DBMS/shortname: bigquery

File: liquibase-commercial-bigquery-<version>.jar

JDBC URL: jdbc:bigquery://<Host>:<Port>;ProjectId=<Project>;OAuthType=<AuthValue>;<Property1>=<Value1>;<Property2>=<Value2>;...

Download: Maven

Google Cloud SQL – MSSQL

2019

DBMS/shortname: mssql

File:mssql-jdbc-<version>.jre-<version>.jar

Class: com.microsoft.sqlserver.jdbc.SQLServerDriver

JDBC URL: jdbc:sqlserver://<host>:<port>/<dbname>;

Download: SQL Server on Google Cloud

Notes: Requires semicolon at end.

Google Cloud SQL – MySQL

8.0

DBMS/shortname: mysql

File: mysql-connector-java-<version>.jar

Class: N/A

JDBC URL: jdbc:mysql://<endpoint>:<port>/<dbname>

Download: Google Cloud SQL for MySQL

Google Cloud SQL – PostgreSQL

16 15 14 13 12 11

DBMS/shortname: postgresql

File: postgresql-<version>.jar Class: com.postgresql.Driver

JDBC URL: jdbc:postgresql://<instance_host>:<instance_port>/<dbname>

Download: Google Cloud SQL for PostgreSQL

IBM DB2 LUW

11.5.7+

DBMS/shortname: db2

File: db2jcc<version>.jar

Class: com.ibm.db2.jcc.DB2Driver

JDBC URL: jdbc:db2://<server-name>:<port>/<dbname> Download: IBM: DB2 JDBC Driver Versions and Downloads

IBM DB2 ZOS

12.0.0 11.5.7+

DBMS/shortname: db2

File: db2jcc<version>.jar

Class: com.ibm.db2.jcc.DB2Driver

JDBC URL: jdbc:db2://<server-name>:<port>/<dbname>

Download: IBM: DB2 JDBC Driver Versions and Downloads

MariaDB Server

11.4 (LTS) 10.6 (LTS)

DBMS/shortname: mariadb

File: mariadb-java-client-<version>.jar

Class: com.mariadb.jdbc.Driver

JDBC URL: jdbc:mariadb://<host>:<port>/<dbname>

Download: MariaDB: About MariaDB Connector/J

Notes: Select the Java 8 connector/j.

MariaDB SkySQL

11.4 (LTS) 10.6 (LTS)

DBMS/shortname: mariadb

File: mariadb-java-client-<version>.jar

Class: com.mariadb.jdbc.Driver

JDBC URL: jdbc:mariadb://<host>:<port>/<dbname>?useSSL=true&serverSslCert=skysql_chain.pem

Download: MariaDB: About MariaDB Connector/J

Notes: Select the Java 8 connector/j.

Microsoft Azure SQL Database

Cloud

DBMS/shortname: mssql

File: mssql-jdbc-<version>.jre-<version>.jar

Class: com.microsoft.sqlserver.jdbc.SQLServerDriver

JDBC URL: jdbc:sqlserver://<endpoint>:<port>/<dbname>;

Download: Azure SQL Database

Note: Requires semicolon at end.

Microsoft Azure SQL Managed Instance

Cloud

DBMS/shortname: mssql

File: mssql-jdbc-<version>.jre-<version>.jar

Class: com.microsoft.sqlserver.jdbc.SQLServerDriver

JDBC URL: jdbc:sqlserver://<endpoint>:<port>/<dbname>;

Download: Azure SQL Database

Note: Requires semicolon at end.

Microsoft SQL Server

2022 2019 2017 2016 2014 (deprecated)

DBMS/shortname: mssql

File: mssql-jdbc-<version>.jre-<version>.jar

Class: com.microsoft.sqlserver.jdbc.SQLServerDriver

JDBC URL: jdbc:sqlserver://<host>:<port>/<dbname>;

Download: Microsoft: Download Microsoft JDBC Driver for SQL Server

Note: Requires semicolon at end.

MongoDB Secure Extension Community and Enterprise Server

8 7 6 5

DBMS/shortname: mongodb

File: mongo-java-driver-<version>.jar

Class: N/A

JDBC URL: jdbc:mongodb://hostname:27017/<dbname>

Reference: MongoDB: Connection String URI Format

Download: Maven: com/mongodb/mongo-java-driver

Extension: GitHub: liquibase/liquibase-mongodb

MongoDB Atlas Secure Extension

8 7 6 5

DBMS/shortname: mongodb

File: mongo-java-driver-<version>.jar

Class: N/A

JDBC URL: jdbc:mongodb://hostname:27017/<dbname>

Reference: MongoDB: Connection String URI Format Download: Maven: com/mongodb/mongo-java-driver

Extension: GitHub: liquibase/liquibase-mongodb

MySQL Server

8.4 8.0 5.7

DBMS/shortname: mysql

File: mysql-connector-java-<version>.jar

Class: N/A

JDBC URL: jdbc:mysql://<servername>:<port>/<dbname>

Download: MySQL: MySQL Community Downloads: Connector/J

Oracle Database

23ai 21c 19c 12.2

DBMS/shortname: oracle

File:ojdbc<version>.jar

Class: oracle.jdbc.OracleDriver

JDBC URL: jdbc:oracle:thin:@<host>:<port>:<dbname>

Download: Oracle: Oracle Database JDBC driver and Companion Jars Downloads

Oracle Autonomous Database

19c

DBMS/shortname: oracle

File: ojdbc<version>.jar

Class: oracle.jdbc.OracleDriver

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

Download: Oracle: Oracle Database JDBC driver and Companion Jars Downloads

Notes: Requires a configured wallet. To view an example, see Using Liquibase with Oracle Autonomous Database with ATP & ADW.

PostgreSQL

17 16 15 14 13 12 (deprecated)

DBMS/shortname: postgresql

File: postgresql-<version>.jar

Class: com.postgresql.Driver

JDBC URL: jdbc:postgresql://<host>:<port>/<dbname>

Download: PostgreSQL: Download

Snowflake

Cloud

DBMS/shortname: snowflake

File: snowflake-jdbc-<version>.jar

Class: net.snowflake.client.jdbc.SnowflakeDriver

JDBC URL: jdbc:snowflake://<account_ID>.snowflakecomputing.com/?<connection_params>

Download: Maven: net/snowflake/snowflake-jdbc

Notes: Requires additional files if using > 128 bit keys. For more information, see Connect Liquibase to Snowflake.

Community-maintained databases

Many Liquibase features are also compatible with databases whose support is not officially maintained by Liquibase. Depending on the database, this functionality is built into Liquibase or contained in extensions separate from Liquibase Core.

For documentation on community-maintained databases, see the Liquibase Contribute Documentation site. For a full list of supported databases, see Supported Databases.