Troubleshooting Databricks JDBC Errors with Liquibase
Last updated: July 14, 2025
Incomplete JDBC URL: [Databricks][DatabricksJDBCDriver](500540)
Condition
You've received this error message:
Unexpected error running Liquibase:
Error executing SQL SELECT MD5SUM FROM main.default.DATABASECHANGELOG WHERE MD5SUM IS NOT NULL: [Databricks][JDBCDriver](500540) Error caught in BackgroundFetcher. Foreground thread ID: 1. Background thread ID: 20.
Error caught: Could not initialize class com.databricks.client.jdbc42.internal.apache.arrow.memory.util.MemoryUtil.
Cause
If you use v1.1.3 of the Liquibase Open Source Databricks extension, you may receive this error running Liquibase
Remedy
To resolve this, append ;UserAgentEntry=Liquibase;EnableArrow=0;
to your JDBC URL. For example, using username/password authentication:
jdbc:databricks://<host>:<port>/<schema>;AuthMech=3;httpPath=/sql/1.0/warehouses/<warehouse>;ConnCatalog=<catalog>;UserAgentEntry=Liquibase;EnableArrow=0;
Connection could not be created to <my _URL> with driver: [Databricks][JDBCDriver](500174)
Condition
You've received this error message:
ERROR: Exception Primary Reason: Connection could not be created to <MY_URL> with driver com.databricks.client.jdbc.Driver. [Databricks][JDBCDriver](500174) Connection property UID has invalid value of <your-email-address>. Valid values are: token.
Cause
If you're using Databricks JDBC driver 2.7.1 or higher, it's possible that token authentication support for your Databricks extension has changed.
Remedy
Verify which version of the Databricks driver you are using. If you're using Databricks Extension driver 2.7.1 or higher, specify username: token and password:<PAT>
or specify UID=token;PWD=<PAT>
in your URL to connect to Databricks.
Missing SSL certificate: [Databricks][JDBCDriver](500593)
Condition
You've received this error message:
Connection could not be created to jdbc:databricks://...; with driver
com.databricks.client.jdbc.Driver.
[Databricks][JDBCDriver](500593) Communication link failure. Failed to connect to server.
Reason: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException:
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException:
unable to find valid certification path to requested target.
Cause
You are receiving this error message because the required SSL certificate is not available in Java versions before 1.8.
Remedy
To resolve this, upgrade Java to version 1.8 or higher.