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

レガシ Databricks JDBC ドライバー

注記

この記事は、Databricks JDBC Simba ドライバーに適用されます。 Databricks が開発した JDBC ドライバーについては、「 Databricks JDBC ドライバー (OSS)」を参照してください。

次の情報は、従来の Databricks JDBC ドライバー 2.6.22 以下に適用されます。 Databricks JDBC Driver 2.6.25 以降に関する情報については、「Databricks JDBC Driver」を参照してください。

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 ドライバーの認証設定」の冒頭を参照してください。
  • <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 モードで使用する場合に推奨されます。

に最終更新