注释
Databricks JDBC 驱动程序 (OSS) 源代码 在 Apache 2.0 许可证下公开提供。
这反映了 Databricks 对透明度、协作和社区驱动开发能力的承诺。 欢迎开发人员、用户和社区提供的贡献。 若要开始,请参阅 贡献指南。
使用 Databricks JDBC 驱动程序(OSS),Databricks JDBC 驱动程序的最新版本,可以通过 Java 数据库连接(JDBC)将 DataGrip 和 DBeaver 等工具连接到 Azure Databricks,这是用于访问数据库管理系统的行业标准规范。
此驱动程序已实现 JDBC API,并提供核心功能,包括 OAuth、Cloud Fetch 以及 Unity Catalog 卷引入等功能。 它运行本机查询模式并支持本机参数化查询,并且可以使用语句执行 API(提供有利的查询结果保留功能)或 Thrift 运行。
注释
在 IBM AIX作系统上,不支持 Apache Arrow 结果格式。 由于 Cloud Fetch 依赖于 Arrow,因此 AIX 不支持 Cloud Fetch。 若要在 SQL 执行过程中避免错误,请通过设置 JDBC 连接属性禁用 Arrow: EnableArrow=0
本文提供有关安装和使用 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 库出现兼容性问题,当将 JDBC 驱动程序与 JDK 16 或更高版本配合使用时,可能会出现运行时错误。 若要防止这些错误,请使用以下 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.6-oss</version> <scope>runtime</scope> </dependency>
对于 Gradle 项目,请将以下依赖项添加到项目的生成文件中,以指示 Gradle 自动下载指定版本的 JDBC 驱动程序:
implementation 'com.databricks:databricks-jdbc:1.0.6-oss'
要查看其他项目类型的依赖项语法,并获取 Databricks JDBC 驱动程序 (OSS) 的最新版本号,请参阅 Maven 存储库。