Tomcat Connection Pool にCData JDBC Driver を設定してAzure Table データに連携

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

CData JDBC Drivers は標準JDBC インターフェースをサポートし、JVM 上で実行されるWeb アプリケーションに統合します。この記事では、Tomcat のConnection Pool からAzure Table に接続する方法について詳しく説明します。

Tomcat のConnection Pool 経由でAzure Table データに接続

1. CData JAR およびCData .lic ファイルを$CATALINA_HOME/lib にコピーします。CData JAR はインストールディレクトリの［lib］サブフォルダ内にあります。
2. コンテキストにリソースの定義を追加します：

   Account プロパティをストレージアカウント名に設定し、ストレージアカウントのAccessKey を設定して接続します。これらの値を取得する方法は次のとおりです。

   ストレージをBackend として使用している場合（デフォルト）

   • Azure ポータルにログインし、左側の「サービス」メニューで「ストレージアカウント」を選択します。
   • ストレージアカウントがない場合は、「追加」ボタンをクリックしてアカウントを作成します。
   • 使用するストレージアカウントのリンクをクリックし、「設定」の「アクセスキー」を選択します。 「アクセスキー」ウィンドウには、ストレージアカウント名とCData 製品で使用するキー（接続にはkey1またはkey2のどちらかを使用できます）が含まれています。これらのプロパティは、それぞれAccount とAccessKey 接続プロパティにマッピングされます。

   Azure SQL への接続

   • Azure ポータルにログインし、左側の「サービス」メニューで「Azure Cosmos DB」を選択します。
   • 使用するCosmos DB アカウントのリンクをクリックし、「設定」の「接続文字列」を選択します。 「接続文字列」ウィンドウには、Cosmos DB アカウント名とCData 製品で使用する主キーが含まれています。これらのプロパティは、それぞれAccount とAccessKey 接続プロパティにマッピングされます。
   <Resource name="jdbc/azuretables" auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.azuretables.AzureTablesDriver" factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" url="jdbc:azuretables:AccessKey=myAccessKey;Account=myAccountName;" maxActive="20" maxIdle="10" maxWait="-1" />

   一つのアプリケーションからAzure Table へのアクセスを許可するには、上のコードをアプリケーションのMETA-INF ディレクトリにあるcontext.xml に追加します。

   共有リソースの設定には、上のコードを$CATALINA_BASE/conf 内にあるcontext.xml に追加します。共有リソースの設定は、すべてのアプリケーションにSalesforce への接続を提供します。

3. アプリケーションのweb.xml にリソースへの参照を追加します。 Azure Table データ JSP jdbc/AzureTables javax.sql.DataSource コンテナ
4. Connection pool からの接続の初期化： Context initContext = new InitialContext(); Context envContext = (Context)initContext.lookup("java:/comp/env"); DataSource ds = (DataSource)envContext.lookup("jdbc/AzureTables"); Connection conn = ds.getConnection();

そのほかのTomcat へのデータ連携ドライバーの統合

上記の手順では、簡単なコネクションプーリングのシナリオでAzure Table に接続する方法を説明しました。ほかの使用例や情報については、 Tomcat 製品ドキュメントの 「JNDI Datasource How-To」をご覧ください。