メインコンテンツまでスキップ

レガシ Databricks JDBC ドライバー

注記

この記事は、Databricks JDBC ドライバー バージョン 2.6.22 以下に適用されます。最新の Databricks JDBC ドライバー (バージョン 3 以上) については、 「Databricks JDBC ドライバー」を参照してください。

JDBC 接続 URL を使用して Databricks 個人用アクセス トークンを使用して認証するには、次のプロパティ コレクションを設定し、 <personal-access-token> を Databricks 個人用アクセス トークンに置き換えます。

jdbc:spark://<server-hostname>:443;httpPath=<http-path>;transportMode=http;SSL=1;UID=token;PWD=<personal-access-token

Databricks では、利用可能な最も安全な認証フローを使用することをお勧めします。この記事で説明する認証フローには、他のフローにはないリスクが伴います。このフローは、マネージド ID などの他のより安全なフローが実行可能でない場合にのみ使用してください。

Java コードを使用して Databricks 個人用アクセス トークンを使用して認証するには、次のプロパティ コレクションを設定し、 <personal-access-token> を Databricks 個人用アクセス トークンに置き換えます。

Java
// ...
String url = "jdbc:spark://<server-hostname>:443;httpPath=<http-path>;transportMode=http;SSL=1";
Properties p = new java.util.Properties();
p.put("UID", "token");
p.put("PWD", "<personal-access-token>");
// ...
DriverManager.getConnection(url, p);
// ...
  • 従来の Databricks JDBC ドライバーでは、 transportMode プロパティと SSL プロパティを設定する必要があります。 Databricks では、これらの値をそれぞれ http と 1に設定することをお勧めします。
  • 必要に応じて適応できる完全な Java コード例については、 「Databricks JDBC ドライバー (Simba) の認証設定」の冒頭を参照してください。
  • <server-hostname> と <http-path>の値を取得するには、次の手順を参照してください。

Databricksクラスターの接続詳細を取得するには:

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

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

  1. Databricksワークスペースにログインします。
  2. サイドバーで、 「SQL」>「SQL ウェアハウス」 をクリックします。
  3. 利用可能なウェアハウスのリストで、対象のウェアハウスの名前をクリックします。
  4. [ 接続の詳細 ] タブで、必要な接続の詳細 ( サーバーのホスト名 、 ポート 、 HTTP パス など) をコピーします。

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

  • 稼働中のクラスターに接続するためのCan Attach Toアクセス許可。
  • Can Restart 接続時にクラスターの状態が終了した場合に、クラスターを自動的にトリガーして開始する権限があります。

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

注記

Databricks SQL ウェアハウスは、Microsoft Power BI を DirectQuery モードで使用する場合に推奨されます。

に最終更新