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

Tomcat Connection Pool からAdobe Analytics に連携接続。

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

最終更新日:2022-09-12

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

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



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

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

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

    Adobe Analytics への接続

    Adobe Analytics に接続するには、GlobalCompanyId およびRSID を識別する必要があります。デフォルトで、ドライバーは会社とレポートスイートの識別を自動で試みますが、これらの値を明示的に指定することもできます。方法はヘルプドキュメントの「Adobe Analytics への接続」セクションを参照してください。

    Adobe Analytics への認証

    Adobe Analytics はOAuth 認証標準を利用しています。 OAuth またはサービスアカウントで認証できます。

    ユーザーアカウント(OAuth)

    すべてのユーザーアカウントフローでAuthSchemeOAuth に設定する必要があります。OAuth 経由のAdobe 認証では、2週間ごとにリフレッシュトークンを更新する必要があります。詳しい認証方法については、ヘルプドキュメントの「Adobe Analytics への認証」セクションを参照してください。

    サービスアカウント

    サービスアカウントにはサイレント認証があり、ブラウザでのユーザー認証は必要ありません。このフローでは、アプリケーションを作成する必要があります。アプリケーションの作成および認可については、ドキュメントの「カスタムOAuth アプリの作成」を参照してください。これでサービスアカウントにアクセス権があるAdobe Analytics データに接続できます。

    サービスアカウントを使用したServer-to-Server OAuthで認証するには、AuthSchemeOAuthClient に設定します。接続するには次のプロパティを設定します。

    • InitiateOAuthGETANDREFRESH に設定。
    • OAuthClientId:アプリケーション設定のクライアントId に設定。
    • OAuthClientSecret:アプリケーション設定のクライアントシークレットに設定。

    接続すると、本製品 はサービスアカウントでのOAuth フローを完了します。

    1. クライアントクレデンシャルOAuth フローで指定されたOAuthClientId およびOAuthClientSecret を使用して、アクセストークンを取得します。
    2. OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化されるようにします。
    3. トークンが期限切れになった際に、新しいアクセストークンを要求します。

    <Resource name="jdbc/adobeanalytics" auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.adobeanalytics.AdobeAnalyticsDriver" factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" url="jdbc:adobeanalytics:GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL;" maxActive="20" maxIdle="10" maxWait="-1" />

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

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

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

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

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

関連コンテンツ

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

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