注
このページは、3 未満の Databricks JDBC ドライバー バージョンに適用されます。 Databricks JDBC ドライバー バージョン 3 以降については、 Databricks JDBC Driver を参照してください。
このページでは、 Databricks JDBC Driver の Azure Databricks コンピューティング リソース設定を構成する方法について説明します。
注
JDBC ドライバーは、ジョブ クラスターへの接続をサポートしていません。
必須の設定
Azure Databricks コンピューティング リソースに接続するには、次の設定を構成します。
| 設定 | 説明 |
|---|---|
Host |
Azure Databricks コンピューティング リソースの サーバー ホスト名 の値。 |
Port |
443 |
HTTPPath |
Azure Databricks コンピューティング リソースの HTTP パス 値。 |
SSL |
1 |
Schema (任意) |
既定のスキーマの名前。 |
Catalog (任意) |
既定のカタログの名前。 |
接続 URL の形式
JDBC 接続 URL には、次の形式を使用します。
jdbc:databricks://<server-hostname>:443;httpPath=<http-path>[;<setting1>=<value1>;<setting2>=<value2>;<settingN>=<valueN>]
Java の例
次の例は、Java を使用して接続を確立する方法を示しています。
// ...
String url = "jdbc:databricks://<server-hostname>:443";
Properties p = new java.util.Properties();
p.put("httpPath", "<http-path>");
p.put("<setting1>", "<value1>");
p.put("<setting2>", "<value2>");
p.put("<settingN>", "<valueN>");
// ...
Connection conn = DriverManager.getConnection(url, p);
// ...
完全な例については、 Databricks JDBC Driver (Simba) の認証設定を参照してください。
<setting>と<value>のプレースホルダーを、認証設定とドライバー機能の設定に置き換えます。
<server-hostname>と<http-path>の値を取得するには、次のセクションを参照してください。
Azure Databricks クラスターの接続の詳細を取得するには:
- Azure Databricks ワークスペースにログインします。
- サイドバーで、[計算] をクリックします。
- 使用可能なクラスターの一覧で、ターゲット クラスターの名前をクリックします。
- [構成] タブで、[詳細オプション] を展開します。
- [JDBC/ODBC] タブをクリックします。
- [サーバー ホスト名]、[ポート]、[HTTP パス] など、必要な接続の詳細をコピーします。
Databricks SQL ウェアハウスの接続の詳細を取得するには、以下の操作を実行します。
- Azure Databricks ワークスペースにログインします。
- サイドバーで、[SQL] > [SQL ウェアハウス] をクリックします。
- 使用可能な倉庫の一覧で、ターゲット ウェアハウスの名前をクリックします。
- [接続の詳細] タブで、[サーバー ホスト名]、[ポート]、[HTTP パス] など、必要な接続の詳細をコピーします。
Azure Databricks クラスターでドライバーを使うには、呼び出し元ユーザーまたはサービス プリンシパルがクラスターに接続するときまたはクラスターを再起動するときに必要な 2 つのアクセス許可があります。
- アタッチ可: 実行中のクラスターに接続するためのアクセス許可。
- 再起動可能: 接続時にクラスターの状態が終了である場合に、その起動を自動的にトリガーするためのアクセス許可。
Databricks SQL ウェアハウスでドライバーを使用するには、呼び出し元のユーザーまたはサービス プリンシパルに、CAN USE権限が必要です。 Databricks SQL ウェアハウスが停止している場合は、自動的に起動します。
注
DirectQuery モードで Microsoft Power BI を使うときは、Databricks SQL ウェアハウスをお勧めします。