连接到 SQL Workbench/J

本文介绍如何将 SQL Workbench/J 与 Azure Databricks 配合使用。

要求

• SQL Workbench/J。

• Databricks JDBC 驱动程序。 将 Databricks JDBC 驱动程序下载到本地开发计算机上，从下载的 DatabricksJDBC42.jar 文件中提取 DatabricksJDBC42-<version>.zip 文件。

  注释

  本文使用 macOS、SQL Workbench/J 内部版本 130、Zulu OpenJDK 21.0.1 和 Databricks JDBC驱动程序 2.6.36 进行了测试。

  对于 Azure Databricks 身份验证，如果你不使用 Azure Databricks 个人访问令牌身份验证，则可跳过之后在这些要求中生成个人访问令牌。 有关可用的 Azure Databricks 身份验证类型的详细信息，请参阅 Databricks JDBC 驱动程序（Simba）的身份验证设置。

• Azure Databricks 工作区中的群集或 SQL 仓库。

  • 计算配置参考。
  • 创建 SQL 仓库。

• 群集或 SQL 仓库的连接详细信息，特别是“服务器主机名”、“端口”和“HTTP 路径”值。

  • 获取 Azure Databricks 计算资源的连接详细信息。

• Azure Databricks 个人访问令牌 或 Microsoft Entra ID（前为 Azure Active Directory）令牌。 若要创建个人访问令牌，请按照 为工作区用户创建个人访问令牌中的步骤作。

  注释

  作为安全最佳做法，在使用自动化工具、系统、脚本和应用进行身份验证时，Databricks 建议使用属于服务主体（而不是工作区用户）的个人访问令牌。 若要为服务主体创建令牌，请参阅 管理服务主体的令牌。

连接 Workbench/J 的步骤

若要连接到 Workbench/J，请执行以下操作：

1. 启动 SQL Workbench/J。
2. 选择 File > Connect 窗口。
3. 在 Select Connection Profile 对话框中，单击 Manage Drivers。
   1. 在 “名称” 字段中，键入 Databricks。
   2. 在 Library 字段中，单击 Select the JAR file（s） 图标。 浏览到从下载DatabricksJDBC42.jar的文件中提取DatabricksJDBC42-<version>.zip文件的目录，然后选择 JAR 文件。 然后，单击“选择”。
   3. 验证“Classname”字段是否已填充 com.databricks.client.jdbc.Driver。
   4. 单击 “确定” 。
4. 单击“新建连接配置文件”图标。
   1. 键入配置文件的名称。
   2. 在“驱动程序”字段中，选择 “Databricks （com.databricks.client.jdbc.Driver）”。
   3. 在“URL”字段中，输入 Azure Databricks 资源的 JDBC URL。 有关 JDBC URL 的 URL 字段语法，请参阅 Databricks JDBC 驱动程序（Simba）的身份验证设置。
   4. 单击测试。
   5. 单击“确定”两次。

其他资源

• SQL 工作台/J