Aqua Data Studio で Databricks のデータ に接続

CData JDBC Driver for Databricks は、Aqua Data Studio などの IDE のウィザードや分析機能と Databricks のデータ を連携できます。本記事では、接続マネージャーを使って Databricks のデータ に接続し、クエリを実行する方法を説明します。

はじめに

---

JDBC データソースの作成

接続マネージャーを使用して接続プロパティを定義し、新しい JDBC データソースとして保存できます。作成した Databricks データソースは、Aqua Data Studio の各ツールからアクセスできるようになります。

1. Aqua Data Studio で、Servers メニューから Register Server を選択します。
2. Register Server フォームで、「Generic - JDBC」接続を選択します。
3. 以下の JDBC 接続プロパティを入力します：
   • Name: データソースの名前を入力します（例：Databricks）。
   • Driver Location: Browse ボタンをクリックし、インストールディレクトリの lib サブフォルダにある cdata.jdbc.databricks.jar ファイルを選択します。
   • Driver: ドライバーのクラス名 cdata.jdbc.databricks.DatabricksDriver を入力します。

   • URL: JDBC URL を入力します。URL は jdbc:databricks: から始まり、その後にセミコロン区切りで接続プロパティを指定します。

     Databricks 接続プロパティの取得・設定方法

     Databricks クラスターに接続するには、以下のプロパティを設定します。

     • Database：Databricks データベース名。
     • Server：Databricks クラスターのサーバーのホスト名。
     • HTTPPath：Databricks クラスターのHTTP パス。
     • Token：個人用アクセストークン。この値は、Databricks インスタンスのユーザー設定ページに移動してアクセストークンタブを選択することで取得できます。
     Databricks インスタンスで必要な値は、クラスターに移動して目的のクラスターを選択し、Advanced Options の下にあるJDBC/ODBC タブを選択することで見つけることができます。

     Databricks への認証

     CData は、次の認証スキームをサポートしています。

     • 個人用アクセストークン
     • Microsoft Entra ID（Azure AD）
     • Azure サービスプリンシパル
     • OAuthU2M
     • OAuthM2M

     個人用アクセストークン

     認証するには、次を設定します。

     • AuthScheme：PersonalAccessToken。
     • Token：Databricks サーバーへの接続に使用するトークン。Databricks インスタンスのユーザー設定ページに移動してアクセストークンタブを選択することで取得できます。

     その他の認証方法については、ヘルプドキュメント の「はじめに」セクションを参照してください。

     組み込みの接続文字列デザイナー

     JDBC URL の作成には、Databricks JDBC Driver に組み込まれている接続文字列デザイナーをご利用いただけます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。

     java -jar cdata.jdbc.databricks.jar
     

     接続プロパティを入力し、接続文字列をクリップボードにコピーします。

     一般的な JDBC URL は以下のとおりです：

     jdbc:databricks:Server=127.0.0.1;HTTPPath=MyHTTPPath;User=MyUser;Token=MyToken;

   

Databricks のデータ へのクエリ

これで、公開されているテーブルにクエリを実行できます。