注意
此页面适用于低于 3 的 Databricks JDBC 驱动程序版本。 有关 Databricks JDBC 驱动程序版本 3 及更高版本,请参阅 Databricks JDBC 驱动程序。
本页介绍如何为 Databricks JDBC 驱动程序配置 Azure Databricks 计算资源设置。
注意
JDBC 驱动程序不支持连接到作业群集。
必需设置
配置以下设置以连接到 Azure Databricks 计算资源:
| 设置 | 说明 |
|---|---|
Host |
Azure Databricks 计算资源的 服务器主机名 值。 |
Port |
443 |
HTTPPath |
Azure Databricks 计算资源的 HTTP 路径 值。 |
SSL |
1 |
Schema(可选) |
默认架构的名称。 |
Catalog(可选) |
默认目录的名称。 |
连接 URL 格式
对 JDBC 连接 URL 使用以下格式:
jdbc:databricks://<server-hostname>:443;httpPath=<http-path>[;<setting1>=<value1>;<setting2>=<value2>;<settingN>=<valueN>]
Java 示例
以下示例演示如何使用 Java 建立连接:
// ...
String url = "jdbc:databricks://<server-hostname>:443";
Properties p = new java.util.Properties();
p.put("httpPath", "<http-path>");
p.put("<setting1>", "<value1>");
p.put("<setting2>", "<value2>");
p.put("<settingN>", "<valueN>");
// ...
Connection conn = DriverManager.getConnection(url, p);
// ...
有关完整示例,请参阅 Databricks JDBC 驱动程序(Simba)的身份验证设置。
将<setting>和<value>占位符替换为身份验证设置和任何驱动程序功能设置。
若要获取其值 <server-hostname> , <http-path>请参阅以下部分。
若要获取 Azure Databricks 群集的连接详细信息,请执行以下操作:
- 登录到你的 Azure Databricks 工作区。
- 在边栏中,单击“计算”。
- 在可用群集列表中,单击目标群集的名称。
- 在“配置”选项卡上,展开“高级选项”。
- 单击“JDBC/ODBC”选项卡。
- 复制所需的连接详细信息,例如服务器主机名、端口和 HTTP 路径。
若要获取 Databricks SQL 仓库的连接详细信息,请执行以下操作:
- 登录到你的 Azure Databricks 工作区。
- 在边栏中单击“SQL”>“SQL 仓库”。
- 在可用仓库列表中,单击目标仓库的名称。
- 在“连接详细信息”选项卡上,复制所需的连接详细信息,例如服务器主机名、端口和 HTTP 路径。
若要将驱动程序用于 Azure Databricks 群集,在连接或重启群集时需要以下两种权限才能调用用户或服务主体:
- “可连接到”权限,用于连接到正在运行的群集。
- “可重启”权限。在连接时,如果群集处于已终止状态,将使用此权限来自动触发群集启动。
若要将驱动程序用于 Databricks SQL 仓库,调用用户或服务主体需要“可使用”权限。 Databricks SQL 仓库停止后会自动启动。
注意
在 DirectQuery 模式下使用 Microsoft Power BI 时,建议使用 Databricks SQL 仓库。