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

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

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

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

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

   URL をFHIR サーバーのService Base URL に設定します。これは接続したいFHIR サーバーでリソースが定義されているアドレスです。ConnectionType をサポートされている接続タイプに設定します。ContentType をドキュメントのフォーマットに設定します。AuthScheme をFHIR サーバーの認証要件に基づいて設定します。

   汎用、Azure ベース、AWS ベース、およびGoogle ベースのFHIR サーバー実装がサポートされます。

   Service Base URL のサンプル

   • 汎用：http://my_fhir_server/r4b/
   • Azure：https://MY_AZURE_FHIR.azurehealthcareapis.com/
   • AWS：https://healthlake.REGION.amazonaws.com/datastore/DATASTORE_ID/r4/
   • Google：https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/

   汎用FHIR インスタンス

   CData 製品はFHIR のカスタムインスタンスへの接続をサポートします。カスタムFHIR サーバーへの認証はOAuth で行います（OAuth の詳細はヘルプドキュメントを参照してください）。カスタムFHIR インスタンスに接続する前に、ConnectionType をGenericに設定する必要があります。

   <Resource name="jdbc/fhir" auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.fhir.FHIRDriver" factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" url="jdbc:fhir:URL=http://test.fhir.org/r4b/;ConnectionType=Generic;ContentType=JSON;AuthScheme=None;" maxActive="20" maxIdle="10" maxWait="-1" />

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

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

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

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

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