Skip to content

Liquibase Database Tutorials: Community-Maintained

Learn how to use Liquibase for your favorite databases with our in-depth tutorials. These tutorials explain how to install and configure your database with Liquibase.

Verification levels

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

A database's verification level refers to the levels of automated and real-world professional testing and certification it has passed. The levels in order of most to least validation are: Advanced, Foundational, Contributed, and Research.

For more information, see Database Verification Levels.

Community-maintained databases

For the full list of supported databases, see Supported Databases. Liquibase supports English language databases only. Other languages with special characters may have issues.

Note

Liquibase-maintained databases can be found here: Liquibase-maintained databases.

Database Verified Database Versions Verification Level Shortname / Driver / Notes
Amazon Keyspaces DBMS/shortname:

File:
Class:
JDBC URL:
Download:
Extension: GitHub: Liquibase Amazon Keyspaces Extension
Apache Derby 10.14 Advanced DBMS/shortname: derby

File: derbytools.jar
Class: org.apache.derby
JDBC URL: jdbc:derby://localhost:1527/MYDATABASE;create=true
Download: Apache Derby: Downloads
Apache Cassandra Contributed DBMS/shortname: cassandra

File: cassandra-jdbc-wrapper-<version>-bundle.jar
Class: com.ing.data.cassandra.jdbc.CassandraDriver
JDBC URL: jdbc:cassandra://localhost:9042/myKeyspace?compliancemode=Liquibase&localdatacenter=DC1
Download: Cassandra JDBC wrapper
Apache Cassandra on DataStax Astra DB Contributed DBMS/shortname: cassandra

File: cassandra-jdbc-wrapper-<version>-bundle.jar
Class: com.ing.data.cassandra.jdbc.CassandraDriver
JDBC URL: jdbc:cassandra:dbaas:///myKeyspace?compliancemode=Liquibase&consistency=LOCAL_QUORUM&user=myUsername&password=myPassword&secureconnectbundle=</path/to/location/secure-connect-bundle-cluster.zip>
Download: Cassandra JDBC wrapper
Aerospike DBMS/shortname: aerospike

File: uber-aerospike-jdbc-<version>.jar
Class: com.aerospike.jdbc.AerospikeDriver
JDBC URL: jdbc:aerospike:<host>:<port>/<namespace>
Download:
Extension: GitHub: Liquibase Aerospike Extension
Azure Cosmos DB Contributed DBMS/shortname: cosmosdb

File: azure-cosmos-<version>.jar
Class: com.azure.cosmos.Driver
JDBC URL: jdbc:cosmosdb://AccountEndpoint=https://<cosmosdb-account-name>.documents.azure.com:443;AccountKey=<accountKey>;
Download: CData: JDBC Driver Download
Extension: GitHub: liquibase/liquibase-cosmosdb

Notes: For Azure Cosmos DB Emulator, use this JDBC URL:jdbc:cosmosdb://localhost:C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==@localhost:8080/testdb1

ClickHouse DBMS/shortname:

File:
Class:
JDBC URL:
Download:
Extension:
Cloud Spanner DBMS/shortname: cloudspanner

File:
Class:
JDBC URL: jdbc:cloudspanner:/projects/<project>/instances/<instance>/databases/<database>
Download: GitHub: Liquibase Spanner Extension
Extension: liquibase-spanner-version-all.jar

Notes: Includes extension and driver.

CockroachDB (on-premises) 20, 21, 22 Advanced DBMS/shortname: cockroachdb

File: postgresql-<version>.jar
Class: org.postgresql.Driver
JDBC URL: jdbc:postgresql://localhost:26257/database?ssl=true&sslmode=require&sslrootcert=/full-path/certs/ca.crt&sslkey=/full-ath/certs/client.user.key.pk8&sslcert=/full-path/certs/client.user.crt
Download: PostgreSQL: Download

Notes: TLS certificate workflow is preferred. The following option is insecure: jdbc:postgresql://localhost:26257/dev

CockroachDB (cloud) 20, 21, 22 Advanced DBMS/shortname: cockroachdb

File: postgresql-<version>.jar
Class: org.postgresql.Driver
JDBC URL: jdbc:postgresql://liquibase-3r8.aws-us-east-2.cockroachlabs.cloud:26257/defaultdb?sslmode=verify-full&sslrootcert=liquibase-ca.crt
Download: PostgreSQL: Download

Notes: Requires TLS certificate workflow.

Firebird RDBMS 3, 4 Advanced DBMS/shortname: firebird

File: jaybird-full-<version>.jar
Class: org.firebirdsql.jdbc.FBDriver
JDBC URL: jdbc:firebirdsql://<IP/host>:<port>//<server/path/to/database>
Download: GitHub: jaybird: releases
Google BigQuery Cloud Foundational DBMS/shortname: bigquery

File: GoogleBigQueryJDBC<version>.jar
Class: com.google.cloud
JDBC URL: jdbc:bigquery://https://googleapis.com/bigquery/v2:443/<dbname>;ProjectId=<STR>;OAuthType=<INT>;
Download: Google: BigQuery
Extension: GitHub: liquibase/liquibase-bigquery
Greenplum Database 6 Foundational DBMS/shortname:

File: postgresql-<version>.jar
Class: org.postgresql.Driver
JDBC URL: jdbc:postgresql://<host>:<port>/<database>
Download: PostgreSQL: Download
H2 Database Engine 1.4, 2.1.21 Advanced DBMS/shortname: h2

File: h2-<version>.jar
Class: NA
JDBC URL:
  • Memory: jdbc:h2:tcp://localhost:9090/mem:dev
  • File: jdbc:h2:file:C:/tools/LB_DBs/H2Example/h2tutorial
Download: Included with Liquibase in <install-directory/internal/lib>

Notes: Included with Liquibase.

HarperDB DBMS/shortname:

File:
Class:
JDBC URL:
Download:
Extension: GitHub: Liquibase HarperDB Extension
Hibernate DBMS/shortname:

File: h2-<version>.jar
Class: liquibase.ext.hibernate.database.connection.HibernateDriver
JDBC URL: hibernate:ejb3:com.liquibase.hibernate.tutorial.jpa
Download: Included with Liquibase in <install-directory/internal/lib>
Extension: GitHub: liquibase/liquibase-hibernate
HyperSQL 2.3, 2.4, 2.5, 2.6, 2.7 Advanced DBMS/shortname: hsqldb

File: hsqldb.jar
Class: org.hsqldb.jdbcDriver
JDBC URL: jdbc:hsqldb:hsql://192.168.1.15:9001/<db-name>
Download: Included with HyperSQL download from SourceForge
IBM DB2 for i Contributed DBMS/shortname: db2

File: db2jcc<version>.jar
Class: com.ibm.as400.access.AS400JDBCDriver
JDBC URL: jdbc:as400://<host>;libraries=<database>;
Download: IBM: DB2 JDBC Driver Versions and Downloads
IBM Db2 for Z Contributed DBMS/shortname: db2

File: db2jcc<version>.jar
Class: com.ibm.db2.jcc.DB2Driver
JDBC URL: jdbc:db2://<host-IP-address>:<port>/<db-name>:retrieveMessagesFromServerOnGetMessage=true;emulateParameterMetaDataForZCalls=1;
Download: IBM: DB2 JDBC Driver Versions and Downloads
Impala/Hive DBMS/shortname:

File: ImpalaJDBC<version>.jar
Class: com.cloudera.impala.jdbc41.Driver
JDBC URL: jdbc:impala://localhost:21050/impala_test
Download: https://www.cloudera.com/downloads/connectors/impala/jdbc/2-6-27.html
Extension: GitHub: Liquibase Impala/Hive Extension
Informix Contributed DBMS/shortname: informix

File: jdbc-<version>.jar
Class: com.informix.jdbc.IfxDriver
JDBC URL: jdbc:informix-sqli://localhost:9088/dbname:INFORMIXSERVER=dbserver
Download: Maven: IBM Informix JDBC Driver

Notes: Requires Informix database in ANSI mode to enable implicit transactions with statements like the following JDBC URL: CREATE DATABASE [ansiDatabase] WITH LOG MODE ANSI;

Interbase DBMS/shortname:

File: interclient.jar
Class: interbase.interclient.Driver
JDBC URL: jdbc:interbase://localhost:3050/interbase/testdb.ib
Download: Downloaded with Interbase from https://www.embarcadero.com/products/interbase/downloads
Extension: GitHub: Liquibase Interbase Extension
InterSystems Caché DBMS/shortname:

File:
Class:
JDBC URL:
Download:
Extension: InterSystems Caché
MongoDB Community Extension 5, 6 Contributed DBMS/shortname: mongodb

File: mongo-java-driver-<version>.jar
Class: NA
JDBC URL: mongodb://hostname:27017/<db-name>
Reference: MongoDB: Connection String URI Format
Download: Maven: org/mongodb/mongo-java-driver
Extension: GitHub: liquibase/liquibase-mongodb
Neo4j Graph Database Foundational DBMS/shortname: neo4j

File:
Class:
JDBC URL: jdbc:neo4j:bolt://<host>:<port>/?username=foo,password=bar
Extension: GitHub: liquibase/liquibase-neo4j
Oracle Timesten DBMS/shortname:

File:
Class:
JDBC URL:
Download:
Extension:
Percona Distribution for MySQL Foundational DBMS/shortname:

File:mysql-connector-java-<version>.jar
Class: NA
JDBC URL:jdbc:mysql://<servername>:<port>/<dbname>
Download: MySQL: MySQL Community Downloads: Connector/J
Percona XtraDB Cluster 5.7, 8.0 Advanced DBMS/shortname:

File:mysql-connector-java-<version>.jar
Class: NA
JDBC URL:jdbc:mysql://<servername>:<port>/<dbname>
Download: MySQL: MySQL Community Downloads: Connector/J
Phoenix/HBase DBMS/shortname:

File:
Class:
JDBC URL:
Download:
Extension: GitHub: Liquibase Phoenix/HBase Extension
SAP HANA Contributed DBMS/shortname: hana

File: ngdbc-<version>.jar
Class: com.sap.db.jdbc.Driver
JDBC URL: jdbc:sap://localhost:30013/?databaseName=mydatabase&encrypt=true
Download: Maven: SAP HANA JDBC Driver
Extension: GitHub: liquibase/liquibase-hanadb
SAP MaxDB Contributed DBMS/shortname: maxdb

File: sapdbc.jar
Class: com.sap.dbtech.jdbc.DriverSapDB
JDBC URL: jdbc:sapdb://localhost:7200/MaxDB1
Download: SAP: SAP MaxDB Product Availability
Extension: GitHub: liquibase/liquibase-maxdb

Notes: To view installed database software packages, including JDBC drivers, run the following command: sdbregview -l

SAP SQL Anywhere 17 Foundational DBMS/shortname: asany

File: sajdbc4.jar
Class: sybase.jdbc.sqlanywhere.IDriver
JDBC URL: jdbc:sqlanywhere:UserID=DBA;Password=passwd;
Download: Included in database client
Sybase (SAP ASE) Contributed DBMS/shortname: sybase

File: jconn4.jar
Class: com.sybase.jdbc4.jdbc.SybDriver
JDBC URL: jdbc:sybase:Tds:127.0.0.1:5000/dbname
Download: Included in database client
SingleStoreDB Cloud Foundational DBMS/shortname:

File:
Class:
JDBC URL:
Download:
SQLite 3.34 Advanced DBMS/shortname: sqlite

File: sqlite-jdbc-<version>.jar
Class: org.sqlite.JDBC
JDBC URL: jdbc:sqlite:example.db
Download: GitHub: xerial/sqlite-jdbc
Teradata Database 17.2 Foundational DBMS/shortname: teradata

File: terajdbc<version>.jar
Class: com.teradata.jdbc.TeraDriver
JDBC URL: jdbc:teradata://hostname/DATABASE=<db-name>
Download: Teradata: Teradata JDBC Driver
Extension: GitHub: liquibase/liquibase-teradata
Vertica Contributed DBMS/shortname: vertica

File: vertica-jdbc-<version>.jar
Class: com.vertica.jdbc.Driver
JDBC URL: jdbc:vertica://localhost:5433/docker
Download: Vertica: Vertica Downloads: Client Drivers
Extension: GitHub: liquibase/liquibase-vertica
VMware vFabric SQLFire Contributed DBMS/shortname:

File:
Class:
JDBC URL:
Download:
Extension: GitHub: Liquibase SQLFire Extension
VoltDB DBMS/shortname:

File:
Class:
JDBC URL:
Download:
Extension: GitHub: Liquibase VoltDB
YugabyteDB 2.6, 2.8, 2.12, 2.14 Foundational DBMS/shortname: yugabytedb

File: postgresql-<version>.jar
Class: org.postgresql.Driver
JDBC URL: jdbc:postgresql://<host>:<port>/<db-name>
Download: PostgreSQL: Download