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

Tomcat Connection Pool からCouchDB に連携接続。

古川えりか
コンテンツスペシャリスト

最終更新日:2022-09-12

この記事で実現できるCouchDB 連携のシナリオ

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



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

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

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

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

    Url 接続プロパティをApache CouchDB インスタンスのURL に設定します。例:http://localhost:5984

    ユーザー(またはJWT)が特定のデータベースだけにアクセスできるようにしたい場合は、Apache CouchDB インスタンスで"admin_only_all_dbs" オプションを設定し、テーブルをリストするために本製品が必要とする"/_all_dbs" エンドポイントへのアクセス権をすべてのユーザーに付与する必要があります。

    Apache CouchDB への認証

    3種類の認証をサポートします。
    • Basic:基本的なユーザー名 / パスワード認証。
    • JWT:JWT 認証。
    • None:パブリックなデータベースへの匿名アクセス。

    Basic 認証

    データに接続するには以下を設定します。

    • AuthSchemeBasic
    • User:認証に使用されるApache CouchDB ユーザーアカウント。
    • Password:認証するユーザーに関連付けられたApache CouchDB パスワード。

    その他の認証方法は、ヘルプドキュメント の「接続の確立」セクションを参照してください。 <Resource name="jdbc/apachecouchdb" auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.apachecouchdb.ApacheCouchDBDriver" factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" url="jdbc:apachecouchdb:Url=http://localhost:5984;User=abc123;Password=abcdef;" maxActive="20" maxIdle="10" maxWait="-1" />

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

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

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

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

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

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。