次の方法で共有

SQL Workbench/J に接続する

  • [アーティクル]

この記事では、Azure Databricks で SQL Workbench/J を使用する方法を説明します。

注意

この記事では、Databricks によって提供もサポートもされていない SQL Workbench/J について説明します。 プロバイダーに問い合わせるには、Google グループの SQL Workbench/J サポート フォーラムを参照してください。

必要条件

  • SQL Workbench/J.

  • Databricks JDBC ドライバー。 Databricks JDBC ドライバーをローカル開発マシンにダウンロードし、ダウンロードした DatabricksJDBC42-<version>.zip ファイルから DatabricksJDBC42.jar ファイルを抽出します。

    Note

    この記事は、macOS、SQL Workbench/J Build 130、Zulu OpenJDK 21.0.1、Databricks JDBC Driver 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. [Generate](生成) をクリックします。
    7. 表示されたトークンを安全な場所にコピーし、[完了] をクリックします。

    Note

    コピーしたトークンは必ず安全な場所に保存してください。 コピーしたトークンは他人に見せないでください。 コピーしたトークンを失った場合、それとまったく同じトークンは再生成できません。 代わりに、この手順を繰り返して新しいトークンを作成する必要があります。 コピーしたトークンを紛失した場合や、トークンが侵害されていると思われる場合、Databricks では、[アクセス トークン] ページのトークンの横にあるごみ箱 ([取り消し]) アイコンをクリックして、ワークスペースからそのトークンをすぐに削除することを強くお勧めします。

    ワークスペースでトークンを作成することや使用することができない場合は、ワークスペース管理者によってトークンが無効にされているか、トークンを作成または使用する権限が作業者に付与されていない可能性があります。 ワークスペース管理者に連絡するか、以下のトピックを参照してください。

    Note

    セキュリティのベスト プラクティスとして、自動化ツール、システム、スクリプト、アプリを使用して認証する場合、Databricks では、ワークスペース ユーザーではなくサービス プリンシパルに属する個人用アクセス トークンを使用することを推奨しています。 サービス プリンシパルのトークンを作成するには、「サービス プリンシパルのトークンを管理する」をご覧ください。

Workbench/J に接続する手順

Workbench/J に接続するには、次の操作を行います。

  1. Workbench/J SQL を起動します。
  2. [ファイル] > [接続] の順に選択します。
  3. [接続プロファイルの選択] ダイアログで、[ドライバーの管理] をクリックします。
    1. 名前フィールドに、Databricks と入力します。
    2. [ライブラリ] フィールドで、JAR ファイルの選択アイコンをクリックします。 ダウンロードした DatabricksJDBC42-<version>.zip ファイルから DatabricksJDBC42.jar ファイルを抽出したディレクトリを参照し、JAR ファイルを選択します。 次に、[選択] をクリックします。
    3. [クラス名] フィールドに com.databricks.client.jdbc.Driver が設定されていることを確認します。
    4. OK をクリックします。
  4. 新しい接続プロファイルを作成するアイコンをクリックします。
    1. プロファイルの名前を入力します。
    2. [ドライバー] フィールドで、[Databricks (com.databricks.client.jdbc.Driver)] を選択します。
    3. [URL] フィールドに、Azure Databricks リソースの JDBC URL を入力します。 JDBC URL の URL フィールド構文については、「Databricks JDBC ドライバーの認証設定」を参照してください。
    4. テストをクリックします。
    5. [OK] を 2 回クリックします。

その他の技術情報