Tomcat Connection Pool にCData JDBC Driver を設定してExcel Online のデータに連携

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

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

Tomcat のConnection Pool 経由でExcel Online のデータに接続

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

   ワークブックに接続するには、Excel Online への認証を提供し、 次のプロパティを設定します。

   • Workbook: ワークブックの名前かId に設定。利用可能なワークブックに関する情報のリストを表示する場合は、認証後にWorkbooks ビューに対してクエリを実行します。

   • UseSandbox: Sandbox アカウントのワークブックに接続している場合はtrue に設定。それ以外の場合は、これを空のままにしてプロダクションアカウントに接続します。

   OAuth 認証を使うこともできます。ユーザー資格情報の接続プロパティを設定せずに接続できます。接続すると、CData 製品はデフォルトブラウザでOAuth エンドポイントを開きます。ログインして、CData 製品にアクセス許可を与えます。CData 製品がOAuth プロセスを完了します。 他のOAuth 認証フローについては、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。

   <Resource name="jdbc/excelonline" auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.excelonline.ExcelOnlineDriver" factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" url="jdbc:excelonline:" maxActive="20" maxIdle="10" maxWait="-1" />

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

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

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

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

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