Jetty の接続プールから Databricks のデータ に接続

CData JDBC Driver for Databricks は、Java Web アプリケーションへの統合が簡単です。この記事では、接続プールを設定することで Jetty から Databricks のデータ に効率的に接続する方法を説明します。Jetty で Databricks 用の JNDI リソースを設定していきましょう。

はじめに

---

Salesforce 用の JDBC Driver を JNDI データソースとして設定

以下のステップで Jetty から Salesforce に接続します。

1. Jetty ベースで JNDI モジュールを有効にします。次のコマンドは、コマンドラインから JNDI を有効にします。

   java -jar ../start.jar --add-to-startd=jndi
   

2. インストールディレクトリの lib サブフォルダにある CData およびライセンスファイルを、コンテキストパスの lib サブフォルダに追加します。

3. リソースとそのスコープを宣言します。リソース宣言に必要な接続プロパティを入力します。次の例では、WEB-INF\jetty-env.xml に Web アプリレベルで Databricks データソースを宣言しています。

   
   <Configure id='databricksdemo' class="org.eclipse.jetty.webapp.WebAppContext">
       <New id="databricksdemo" class="org.eclipse.jetty.plus.jndi.Resource">
       <Arg><Ref refid="databricksdemo"/></Arg>
       <Arg>jdbc/databricksdb</Arg>
       <Arg>
         <New class="cdata.jdbc.databricks.DatabricksDriver">
           <Set name="url">jdbc:databricks:</Set>
           <Set name="Server">127.0.0.1</Set>
           <Set name="HTTPPath">MyHTTPPath</Set>
           <Set name="User">MyUser</Set>
           <Set name="Token">MyToken</Set>
         </New>
       </Arg>
     </New>
   </Configure>
   

   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 インスタンスのユーザー設定ページに移動してアクセストークンタブを選択することで取得できます。

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

4. Web.xml でリソースを設定します。

   
     jdbc/databricksdb
     javax.sql.DataSource
     Container
   
   

5. これで、java:comp/env/jdbc/databricksdb をルックアップして Databricks にアクセスできます。

   InitialContext ctx = new InitialContext();
   DataSource mydatabricks = (DataSource)ctx.lookup("java:comp/env/jdbc/databricksdb");
   

Jetty 統合の詳細

上記のステップでは、シンプルな接続プールのシナリオでドライバーを設定する方法を説明しました。その他のユースケースや詳細については、Jetty ドキュメントのWorking with Jetty JNDI の章を参照してください。