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

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

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

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

// ...
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 ウェアハウスは、 DirectQuery モードで Microsoft Power BI を使用する場合に推奨されます。