Important
このドキュメントは廃止され、更新されない可能性があります。 このコンテンツに記載されている製品、サービス、またはテクノロジはサポートされなくなりました。 SQL Workbench のドキュメントを参照してください。
この記事では、Azure Databricks で SQL Workbench/J を使用する方法を説明します。
注
この記事では、サード パーティによって開発された SQL Workbench/J について説明します。 プロバイダーに問い合わせるには、 SQL Workbench/J を参照してください。
Requirements
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 (Simba) の認証設定に関するページを参照してください。
Azure Databricks ワークスペース内のクラスターまたは SQL ウェアハウス。
クラスターまたは SQL ウェアハウスの接続の詳細。具体的には、 サーバーのホスト名、 ポート、 および HTTP パス の値です。
Azure Databricks 個人用アクセス トークン または Microsoft Entra ID (旧称 Azure Active Directory) トークン。 個人用アクセス トークンを作成するには、「 ワークスペース ユーザーの個人用アクセス トークンを作成する」の手順に従います。
注
セキュリティのベスト プラクティスとして、自動化されたツール、システム、スクリプト、アプリを使用して認証する場合、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 (Simba) の認証設定を参照してください。
- [ テスト] をクリックします。
- [ OK] を 2 回クリックします。