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

Databricks JDBC ドライバーを使用して Databricks への接続を構成する

注記

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

この記事では、 Databricks JDBC ドライバーを使用して Databricks への接続を構成する方法について説明します。

ドライバーの Databricks接続を構成するには、DatabricksJDBCコンピュート リソースの設定 、ドライバー機能の設定 、 および認証設定を、JDBC 接続 URL またはJDBC 接続プロパティのプログラムによるコレクション、あるいはその両方に組み合わせる必要があります。

JDBC 接続 URL は、次の形式を使用します。

jdbc:databricks://<server-hostname>:443;httpPath=<http-path>[;<setting1>=<value1>;<setting2>=<value2>;<settingN>=<valueN>]

JDBC 接続プロパティは、次の例のように Java で設定できます。

Java
package org.example;

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.ResultSetMetaData;
import java.sql.Statement;
import java.util.Properties;

public class Main {
  public static void main(String[] args) throws Exception {
    Class.forName("com.databricks.client.jdbc.Driver");
    String url = "jdbc:databricks://" + System.getenv("DATABRICKS_SERVER_HOSTNAME") + ":443";
    Properties p = new java.util.Properties();
    p.put("httpPath", System.getenv("DATABRICKS_HTTP_PATH"));
    p.put("<setting1>", "<value1");
    p.put("<setting2>", "<value2");
    p.put("<settingN>", "<valueN");
    try (Connection conn = DriverManager.getConnection(url, p)) {
      Statement stmt = conn.createStatement();
      try (ResultSet rs = stmt.executeQuery("<query>")) {
        ResultSetMetaData md = rs.getMetaData();
        String[] columns = new String[md.getColumnCount()];
        for (int i = 0; i < columns.length; i++) {
          columns[i] = md.getColumnName(i + 1);
        }
        while (rs.next()) {
          System.out.print("Row " + rs.getRow() + "=[");
          for (int i = 0; i < columns.length; i++) {
            if (i != 0) {
              System.out.print(", ");
            }
            System.out.print(columns[i] + "='" + rs.getObject(i + 1) + "'");
          }
          System.out.println(")]");
        }
      }
    }
    System.exit(0);
  }
}
  • DATABRICKS_SERVER_HOSTNAME 環境と DATABRICKS_HTTP_PATH 環境の値を、ターゲット リソースDatabricks コンピュート リソースの [サーバー ホスト名 ] と [HTTP パス ] の値をそれぞれ設定します。これらの値を取得するには、「Databricks JDBC ドライバーのコンピュート設定」を参照してください。環境変数を設定するには、オペレーティングシステムのドキュメントを参照してください。
  • 必要に応じて、選択した認証タイプのプロパティの <setting> と <value> を置き換えます。
  • また、特別な ドライバー機能設定や高度なドライバー機能設定を、通常は追加の <setting> と <value> のペアとして追加することもできます。
  • この例では、 <query> を SQL SELECT クエリ文字列に置き換えます。

接続 URL を使用するか、接続プロパティのコレクションを使用するかは、ターゲット アプリ、ツール、クライアント、SDK、または API の要件によって異なります。

に最終更新