Download and reference the Databricks JDBC Driver (Simba)

Note

This page applies to the Simba JDBC Driver (Legacy), versions below version 3. Databricks strongly recommends migrating to the Databricks JDBC Driver for JDBC connectivity. It includes improvements such as support for Unity Catalog metric views, transactions that span multiple SQL statements, stored procedures, faster large-result retrieval, and built-in client telemetry.

This page describes how to download and reference the Databricks JDBC Driver.

Before downloading the driver, review the JDBC ODBC driver license.

Manually download the driver

Some tools, such as DataGrip, DBeaver, and SQL Workbench/J, require you to manually download the JDBC driver before connecting to Azure Databricks.

If you use Maven or Gradle, these tools download the driver automatically. Skip to Reference the driver in Java.

To manually download the driver:

  1. Go to the All JDBC Driver Versions (Open Source) download page.
  2. Click Download for the latest version. The driver is a .jar file that doesn't require installation.

Reference the driver in Java

Choose one of the following methods to reference the JDBC driver in your Java code:

  • Manual download: Add the downloaded .jar file to your Java classpath.

  • Maven: Add this dependency to your pom.xml file:

    <dependency>
      <groupId>com.databricks</groupId>
      <artifactId>databricks-jdbc</artifactId>
      <version>2.7.5</version>
    </dependency>
    
  • For Gradle projects, add this dependency to your build file:

    implementation 'com.databricks:databricks-jdbc:2.7.5'
    

For other build tools and the latest version number, see the Maven Central Repository.

Next steps

Configure your Azure Databricks connection: