Databricks JDBC 驱动程序 (OSS)

使用 Databricks JDBC 驱动程序(OSS),Databricks JDBC 驱动程序的最新版本,可以通过 Java 数据库连接(JDBC)将 DataGripDBeaver 等工具连接到 Azure Databricks,这是用于访问数据库管理系统的行业标准规范。

此驱动程序已实现 JDBC API,并提供核心功能,包括 OAuth、Cloud Fetch 以及 Unity Catalog 卷引入等功能。 它运行本机查询模式并支持本机参数化查询,并且可以使用语句执行 API(提供有利的查询结果保留功能)或 Thrift 运行。

本文提供有关安装和使用 Databricks JDBC 驱动程序 (OSS) 的信息。 有关非 OSS Databricks JDBC 驱动程序的信息,请参阅 Databricks JDBC 驱动程序

要求

若要使用 Databricks JDBC 驱动程序 (OSS),必须满足以下要求:

  • Java Runtime Environment (JRE) 11.0 或更高版本。 JRE 11、17 和 21 支持 CI 测试。

注意

JDK 16 中的一项变更导致 JDBC 驱动程序使用的 Apache Arrow 库出现兼容性问题,因此在 JDK 16 或以上版本中使用 JDBC 驱动程序时可能会出现运行时错误。 要防止这些错误,请使用以下 JVM 命令选项重启应用程序或驱动程序:

--add-opens=java.base/java.nio=org.apache.arrow.memory.core ALL-UNNAMED

安装驱动程序

Databricks JDBC 驱动程序 (OSS) 在 Maven 存储库中发布。

若要安装驱动程序,可以执行以下任一操作:

  • 对于 Maven 项目,请将以下依赖项添加到项目的 pom.xml 文件中,以指示 Maven 自动下载指定版本的 JDBC 驱动程序:

    <dependency>
      <groupId>com.databricks</groupId>
      <artifactId>databricks-jdbc</artifactId>
      <version>1.0.1-oss</version>
      <scope>runtime</scope>
    </dependency>
    
  • 对于 Gradle 项目,请将以下依赖项添加到项目的生成文件中,以指示 Gradle 自动下载指定版本的 JDBC 驱动程序:

    implementation 'com.databricks:databricks-jdbc:1.0.1-oss'
    

要查看其他项目类型的依赖项语法,并获取 Databricks JDBC 驱动程序 (OSS) 的最新版本号,请参阅 Maven 存储库

后续步骤

其他资源