Databricks JDBC 驱动程序的计算设置

本文介绍如何为 Databricks JDBC 驱动程序配置 Azure Databricks 计算资源设置。

本文对以下 Databricks JDBC 驱动程序文章中的信息进行了补充:

若要为 Databricks JDBC 驱动程序配置 Azure Databricks 连接,必须将身份验证设置、任何驱动程序功能设置和以下计算资源设置合并到 JDBC 连接 URL 或 JDBC 连接属性的编程集合中。 无论是使用连接 URL 还是连接属性集合,都需要遵循目标应用、工具、客户端、SDK 或 API 的要求。 有关 JDBC 连接 URL 和 JDBC 连接属性的编程集合的示例,请参阅 Databricks JDBC 驱动程序的身份验证设置

该驱动程序需要以下计算资源配置设置:

设置 说明
Host Azure Databricks 计算资源的“服务器主机名”值。
Port 443
HTTPPath Azure Databricks 计算资源的“HTTP 路径”值。
SSL 1
ThriftTransport 2
Schema(可选) 要使用的默认架构的名称。
Catalog(可选) 要使用的默认目录的名称。

使用上述设置的 JDBC 连接 URL 具有以下格式:

jdbc:databricks://<server-hostname>:443;httpPath=<http-path>[;<setting1>=<value1>;<setting2>=<value2>;<settingN>=<valueN>]

使用上述设置的 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);
// ...

若要获取 Azure Databricks 群集的连接详细信息,请执行以下操作:

  1. 登录到你的 Azure Databricks 工作区。
  2. 在边栏中,单击“计算”。
  3. 在可用群集列表中,单击目标群集的名称。
  4. 在“配置”选项卡上,展开“高级选项”。
  5. 单击“JDBC/ODBC”选项卡
  6. 复制所需的连接详细信息,例如服务器主机名、端口和 HTTP 路径。

若要获取 Databricks SQL 仓库的连接详细信息,请执行以下操作:

  1. 登录到你的 Azure Databricks 工作区。
  2. 在边栏中单击“SQL”>“SQL 仓库”。
  3. 在可用仓库列表中,单击目标仓库的名称。
  4. 在“连接详细信息”选项卡上,复制所需的连接详细信息,例如服务器主机名、端口和 HTTP 路径

若要将驱动程序用于 Azure Databricks 群集,在连接或重启群集时需要以下两种权限才能调用用户或服务主体:

  • “可连接到”权限,用于连接到正在运行的群集。
  • “可重启”权限。在连接时,如果群集处于已终止状态,将使用此权限来自动触发群集启动。

若要将驱动程序用于 Databricks SQL 仓库,调用用户或服务主体需要“可使用”权限。 Databricks SQL 仓库停止后会自动启动。

注意

在 DirectQuery 模式下使用 Microsoft Power BI 时,建议使用 Databricks SQL 仓库