SQL Workbench/J に接続する

この記事では、SQL Workbench/J を 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 Build 130、Zulu OpenJDK 21.0.1、Databricks JDBC Driver 2.6.36 でテストされています。

    Databricks 認証の場合、Databricks 個人用アクセストークン認証を使用していない場合は、これらの要件の後半で個人用アクセストークンの生成をスキップできます。 使用可能な Databricks 認証の種類の詳細については、「 Databricks JDBC ドライバーの認証設定」を参照してください。

  • Databricks ワークスペース内のクラスターまたは SQLウェアハウス。

  • クラスターまたは SQLウェアハウスの接続の詳細 (具体的には、 サーバーのホスト名、 ポート、 および HTTP パス の値)。

  • Databricksの個人的なアクセス権。 個人的なアクセスウイルスを作成するには、次の手順を実行します。

    1. Databricks ワークスペースで、上部のバーにある Databricks ユーザー名をクリックし、ドロップダウンから[設定]を選択します。

    2. [ 開発者] をクリックします。

    3. [アクセストークン] の横にある [管理] をクリックします。

    4. [ 新しいトークンの生成] をクリックします。

    5. （任意）今後このトークンを識別するのに役立つコメントを入力し、トークンのデフォルトの有効期間である90日を変更します。有効期間のないトークンを作成するには（非推奨）、[有効期間 (日) ] ボックスを空白のままにしてください。

    6. [生成] をクリックします。

    7. 表示されたトークンを安全な場所にコピーし、[完了] をクリックします。

    注

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

    ワークスペースでトークンを作成または使用できない場合は、ワークスペース管理者がトークンを無効にしたか、トークンを作成または使用する権限を与えていないことが原因である可能性があります。ワークスペース管理者に問い合わせるか、以下をご覧ください。

    注

    自動化されたツール、システム、スクリプト、アプリを使用して認証する場合のセキュリティのベスト プラクティスとして、Databricks ではOAuth トークンを使用することをお勧めします。

    個人用アクセストークン認証を使用する場合、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. OK をクリックします。

  4. 「 新規接続プロファイルの作成 」アイコンをクリックします。

    1. プロファイルの名前を入力します。

    2. [ドライバー] フィールドで、 [Databricks (com.databricks.client.JDBCを選択します。Driver)です。

    3. [ URL ] フィールドに、Databricks リソースの JDBC URL を入力します。 JDBC URL の URL フィールドの構文については、「 Databricks JDBC ドライバーの認証設定」を参照してください。

    4. [ テスト] をクリックします。

    5. [OK] を 2 回クリックします。

関連リソース