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

CData JDBC Driver for AlloyDB は、Java Web アプリケーションへの統合が簡単です。この記事では、接続プールを設定することで Jetty から AlloyDB のデータ に効率的に接続する方法を説明します。Jetty で AlloyDB 用の 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 アプリレベルで AlloyDB データソースを宣言しています。

   
   <Configure id='alloydbdemo' class="org.eclipse.jetty.webapp.WebAppContext">
       <New id="alloydbdemo" class="org.eclipse.jetty.plus.jndi.Resource">
       <Arg><Ref refid="alloydbdemo"/></Arg>
       <Arg>jdbc/alloydbdb</Arg>
       <Arg>
         <New class="cdata.jdbc.alloydb.AlloyDBDriver">
           <Set name="url">jdbc:alloydb:</Set>
           <Set name="User">alloydb</Set>
           <Set name="Password">admin</Set>
           <Set name="Database">alloydb</Set>
           <Set name="Server">127.0.0.1</Set>
           <Set name="Port">5432</Set>
         </New>
       </Arg>
     </New>
   </Configure>
   

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

   AlloyDB に接続するには、次の接続プロパティが必要です。

   • Server：AlloyDB データベースをホスティングしているサーバーのホスト名またはIP アドレス。
   • Port（オプション）：AlloyDB データベースをホスティングしているサーバーのポート。このプロパティはデフォルトで5432に設定されます。
   • User：AlloyDB サーバーに認証する際に使われるユーザー。
   • Password：AlloyDB サーバーに認証する際に使われるパスワード。
   • Database（オプション）：AlloyDB サーバーに接続する場合のデータベース。設定されていない場合は、ユーザーのデフォルトデータベースが使用されます。

   AlloyDB への認証

   標準認証

   標準認証（事前に提供されたユーザーとパスワードの組み合わせを使用）は、デフォルトの認証形式です。

   標準認証で接続する場合は、これ以上のアクションは必要ありません。

   pg_hba.conf 認証スキーム

   CData 製品がサポートしている他の認証方法では、AlloyDB サーバー上のpg_hba.conf ファイルで有効化する必要があります。

   AlloyDB サーバーでの認証の設定については、こちらを参照してください。

   MD5

   pg_hba.conf ファイルのauth-method をmd5 に設定すると、MD5 パスワード検証を使用して認証できます。

   SASL

   CData 製品は、SASL（特にSCRAM-SHA-256）でパスワードを検証することで認証できます。

   この認証方法を使用するには、pg_hba.conf ファイルのauth-method をscram-sha-256 に設定します。

   Kerberos

   Kerberos 認証は、CData 製品が接続を試行している際にAlloyDB サーバーで開始されます。この認証方法を有効化するには、AlloyDB サーバーでKerberos を設定します。AlloyDB サーバーでのKerberos 認証の設定を完了したら、CData 製品からKerberos 認証を行う方法については、ヘルプドキュメントの「Kerberos の使用」セクションを参照してください。

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

   
     jdbc/alloydbdb
     javax.sql.DataSource
     Container
   
   

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

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

Jetty 統合の詳細

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