注释
Databricks JDBC 驱动程序 源代码 在 Apache 2.0 许可证下公开提供。
这反映了 Databricks 对透明度、协作和社区驱动开发能力的承诺。 欢迎开发人员、用户和社区提供的贡献。 若要开始,请参阅 贡献指南。
使用 Databricks JDBC 驱动程序可以通过 Java 数据库连接 (JDBC) 将 DataGrip、DBeaver 和 SQL Workbench/J 等工具连接到 Azure Databricks,这是一种访问数据库管理系统的行业标准规范。
此驱动程序已实现 JDBC API,并提供核心功能,包括 OAuth、Cloud Fetch 以及 Unity Catalog 卷引入等功能。 它运行本机查询模式并支持本机参数化查询,并且可以使用语句执行 API(提供有利的查询结果保留功能)或 Thrift 运行。
本页提供有关安装和使用 Databricks JDBC 驱动程序、版本 3 及更高版本的信息。 有关 Simba JDBC 驱动程序(旧版)的信息(适用于版本 3 以下),请参阅 Simba JDBC 驱动程序(旧版)。
要求
若要使用 Databricks JDBC 驱动程序,必须满足以下要求:
- Java运行时环境 (JRE) 11.0 或更高版本。 JRE 11、17 和 21 支持 CI 测试。
专用 JDK 8 分支适用于需要与 Java 8 兼容的用户。 用户可以根据需要从此分支生成 JAR。 此分支定期与主分支同步,但欢迎社区贡献使其保持更新。 请参阅 Databricks JDBC 驱动程序 JDK 8 分支。
安装驱动程序
Databricks JDBC 驱动程序在 Maven 存储库中发布。
若要安装驱动程序,可以执行以下任一操作:
对于 Maven 项目,请将以下依赖项添加到项目的
pom.xml文件中,以指示 Maven 自动下载指定版本的 JDBC 驱动程序:<dependency> <groupId>com.databricks</groupId> <artifactId>databricks-jdbc</artifactId> <version>3.3.1</version> <scope>runtime</scope> </dependency>对于 Gradle 项目,请将以下依赖项添加到项目的生成文件中,以指示 Gradle 自动下载指定版本的 JDBC 驱动程序:
implementation 'com.databricks:databricks-jdbc:3.3.1'
若要查看其他项目类型的依赖项语法,并获取 Databricks JDBC 驱动程序的最新版本号,请参阅 Maven 存储库。
后续步骤
- 配置连接 URL
- 身份验证属性
- SQL 配置属性
- SSL 信任存储配置
- 启用日志记录
- 管理卷中的文件
- 示例:使用 JDBC 驱动程序运行查询
- 示例:使用事务
- 使用 Databricks JDBC 驱动程序处理指标视图元数据