通过

连接到 SQL Workbench/J

  • 项目

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

注意

本文介绍了 Databricks 既不提供也不支持的 SQL Workbench/J。 若要联系提供商，请参阅 Google 网上论坛中的 SQL Workbench/J 支持论坛。

要求

  • SQL Workbench/J。

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

    注意

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

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

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

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

  • Azure Databricks 个人访问令牌或 Microsoft Entra ID（以前称为 Azure Active Directory）令牌…… 若要创建个人访问令牌，请执行以下操作：

    1. 在 Azure Databricks 工作区中，单击顶部栏中的 Azure Databricks 用户名，然后从下拉列表中选择“设置”。
    2. 单击“开发人员”。
    3. 在“访问令牌”旁边，单击“管理”。
    4. 单击“生成新令牌”。
    5. （可选）输入有助于将来识别此令牌的注释，并将令牌的默认生存期更改为 90 天。 若要创建没有生存期的令牌（不建议），请将“生存期(天)”框留空（保留空白）。
    6. 单击“生成” 。
    7. 将显示的令牌复制到安全位置，然后单击“完成”。

    注意

    请务必将复制的令牌保存到安全的位置。 请勿与他人共享复制的令牌。 如果丢失了复制的令牌，你将无法重新生成完全相同的令牌， 而必须重复此过程来创建新令牌。 如果丢失了复制的令牌，或者认为令牌已泄露，Databricks 强烈建议通过单击“访问令牌”页上令牌旁边的垃圾桶（撤销）图标立即从工作区中删除该令牌。

    如果你无法在工作区中创建或使用令牌，可能是因为工作区管理员已禁用令牌或未授予你创建或使用令牌的权限。 请与工作区管理员联系，或参阅以下主题：

    注意

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

连接 Workbench/J 的步骤

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

  1. 启动 SQL Workbench/J。
  2. 选择“文件>连接窗口”。
  3. 在“选择连接配置文件”对话框中，单击“管理驱动程序”。
    1. 在名称字段中，键入 Databricks。
    2. 在“库”字段中，单击“选择 JAR 文件”图标。 浏览到从下载的 DatabricksJDBC42-<version>.zip 文件中提取 DatabricksJDBC42.jar 文件的目录，然后选择 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 驱动程序的身份验证设置。
    4. 单击测试。
    5. 单击“确定”两次。

其他资源