Databricks JDBC Driver (Simba) のコンピューティング設定

注

このページは、バージョン 3 より前のバージョンの Simba JDBC Driver (Legacy) に適用されます。 Databricks では、 Databricks JDBC Driver for JDBC 接続への移行を強くお勧めします。 これには、Unity カタログ メトリック ビューのサポート、複数の SQL ステートメントにまたがるトランザクション、ストアド プロシージャ、大規模な結果の取得の高速化、組み込みのクライアント テレメトリなどの機能強化が含まれています。

このページでは、 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 クラスターの接続の詳細を取得するには:

  1. Azure Databricks ワークスペースにログインします。
  2. サイドバーで、[計算] をクリックします。
  3. 使用可能なクラスターの一覧で、ターゲット クラスターの名前をクリックします。
  4. [構成] タブで、[詳細オプション] を展開します。
  5. [JDBC/ODBC] タブをクリックします。
  6. [サーバー ホスト名]、[ポート]、[HTTP パス] など、必要な接続の詳細をコピーします。

Databricks SQL ウェアハウスの接続の詳細を取得するには、以下の操作を実行します。

  1. Azure Databricks ワークスペースにログインします。
  2. サイドバーの [ SQL] で、[ SQL Warehouses] をクリックします。
  3. 使用可能な倉庫の一覧で、ターゲット ウェアハウスの名前をクリックします。
  4. [接続の詳細] タブで、[サーバー ホスト名]、[ポート]、[HTTP パス] など、必要な接続の詳細をコピーします。

Azure Databricks クラスターでドライバーを使うには、呼び出し元ユーザーまたはサービス プリンシパルがクラスターに接続するときまたはクラスターを再起動するときに必要な 2 つのアクセス許可があります。

  • アタッチ可: 実行中のクラスターに接続するためのアクセス許可。
  • 再起動可能: 接続時にクラスターの状態が終了である場合に、その起動を自動的にトリガーするためのアクセス許可。

Databricks SQL ウェアハウスでドライバーを使用するには、呼び出し元のユーザーまたはサービス プリンシパルに、CAN USE権限が必要です。 Databricks SQL ウェアハウスが停止している場合は、自動的に起動します。

注

DirectQuery モードで Microsoft Power BI を使うときは、Databricks SQL ウェアハウスをお勧めします。