この記事では、Azure Databricks で SQL Workbench/J を使用する方法を説明します。
注意
この記事では、サード パーティによって開発された SQL Workbench/J について説明します。 プロバイダーに問い合わせるには、Google グループの SQL Workbench/J サポート フォーラム を参照してください。
必要条件
Databricks JDBC ドライバー。 Databricks JDBC ドライバーをローカル開発マシンにダウンロードし、ダウンロードした
DatabricksJDBC42.jar
ファイルからDatabricksJDBC42-<version>.zip
ファイルを抽出します。注意
この記事は、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 Driver の認証設定」を参照してください。
Azure Databricks ワークスペース内のクラスターまたは SQL ウェアハウス。
クラスターまたは SQL ウェアハウスの接続の詳細。具体的には、 サーバーのホスト名、 ポート、 および HTTP パス の値です。
Azure Databricks 個人用アクセス トークン または Microsoft Entra ID (旧称 Azure Active Directory) トークン。 個人用アクセス トークンを作成するには、「ワークスペース ユーザーの Azure Databricks 個人用アクセス トークンの手順に従います。
注意
セキュリティのベスト プラクティスとして、自動化されたツール、システム、スクリプト、アプリを使用して認証する場合、Databricks では、ワークスペース ユーザーではなく サービス プリンシパル に属する個人用アクセス トークンを使用することをお勧めします。 サービス プリンシパルのトークンを作成するには、サービス プリンシパル のトークンの管理に関するページを参照してください。
Workbench/J に接続する手順
Workbench/J に接続するには、次の操作を行います。
- Workbench/J SQL を起動します。
- ファイル>接続ウィンドウを選択します。
- [ 接続プロファイルの選択 ] ダイアログで、[ ドライバーの管理] をクリックします。
- [ 名前 ] フィールドに「
Databricks
」と入力します。 - [ ライブラリ ] フィールドで、[ JAR ファイルの選択 ] アイコンをクリックします。 ダウンロードした
DatabricksJDBC42.jar
ファイルからDatabricksJDBC42-<version>.zip
ファイルを抽出したディレクトリを参照し、JAR ファイルを選択します。 次に、[ 選択] をクリックします。 -
[クラス名] フィールドに
com.databricks.client.jdbc.Driver
が設定されていることを確認します。 - [ OK] をクリックします。
- [ 名前 ] フィールドに「
- [ 新しい接続プロファイルの作成 ] アイコンをクリックします。
- プロファイルの名前を入力します。
- [ドライバー] フィールドで、 Databricks (com.databricks.client.jdbc.Driver) を選択します。
- [URL] フィールドに、Azure Databricks リソースの JDBC URL を入力します。 JDBC URL の URL フィールド構文については、 Databricks JDBC Driver の認証設定を参照してください。
- [ テスト] をクリックします。
- [ OK] を 2 回クリックします。