Jetty コネクションプールからFacebook Ads データに連携。

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData JDBC Driver for FacebookAds は、Java Web アプリケーションに簡単に統合して利用することができます。本記事では、Jetty でドライバーをコネクションプールとして設定することで、効率的にFacebook Ads データをアプリケーションで連携利用する方法を説明します。Jetty でJNDI resource for FacebookAds を設定します。

DBC Driver for FacebookAds を JNDI Data Source として設定

次の手順で、Jetty とFacebook Ads の接続を確立します。

1. Jetty ベースでJNDI モジュールを有効化します。JNDI を有効化するコマンドラインは以下の通り:

   java -jar ../start.jar --add-to-startd=jndi
2. JDBC Driver の.jar ファイルと.lic ファイル（インストールディレクトリのlib フォルダ下）をcontext path のlib フォルダに配置します。
3. リソースおよびスコープを宣言します。リソース宣言で必要な接続プロパティを入力します。この例では、Facebook Ads データソースをWeb アプリケーションのWEB-INF\jetty-env.xml レベルにdeclare しています。
   <Configure id='facebookadsdemo' class="org.eclipse.jetty.webapp.WebAppContext"> <New id="facebookadsdemo" class="org.eclipse.jetty.plus.jndi.Resource"> <Arg><Ref refid="facebookadsdemo"/></Arg> <Arg>jdbc/facebookadsdb</Arg> <Arg> <New class="cdata.jdbc.facebookads.FacebookAdsDriver"> <Set name="url">jdbc:facebookads:</Set> </New> </Arg> </New> </Configure>

   Facebook Ads 接続プロパティの取得・設定方法

   ほとんどのテーブルで、アプリケーション認証と同様にユーザー認証を必要とします。Facebook Ads はユーザー認証にOAuth 標準を使用しています。Facebook への認証には、組み込み認証を使用してブラウザ経由で完結することもできますし、Facebook にアプリを登録することで独自のOAuthClientId、OAuthClientSecret、CallbackURL を取得することもできます。

   の設定方法については、ヘルプドキュメントの「OAuth」セクションを参照してください。

   任意で以下の項目を設定して、フィルタリングや集計を行うもできます。必要に応じてご利用ください。

   • Target：Facebook データのテーブルのいくつかはターゲットでフィルタリングできます。例えば、動画のコメントを取得するにはターゲットに動画のID を指定します。このプロパティは、クエリ結果を指定されたターゲットに合致するレコードにフィルタリングします。Target カラムを使ってクエリ毎にこの制限をかけることができます。
   • AggregateFormat：CData 製品は、いくつかのカラムを文字列集合として返します。例えば、エンティティのいいねデータは集計されて返されます。デフォルトでは、CData 製品はJSON で集計カラムを返します。集計をXML で返すことも可能です。
   • RetryLevel：このプロパティを使用して、特定の広告インサイトのクエリとエラーに対するクエリの自動再試行を制御します。

4. Web xml でリソースを設定します:

   jdbc/facebookadsdb javax.sql.DataSource Container

5. これで、java:comp/env/jdbc/facebookadsdb へのルックアップでFacebook Ads データにアクセスできます: InitialContext ctx = new InitialContext(); DataSource myfacebookads = (DataSource)ctx.lookup("java:comp/env/jdbc/facebookadsdb");

Jetty にさらに統合

ここでは、シンプルなコネクションプーリングシナリオでのドライバーの接続について説明しました。追加での連携ケースについては、Jetty ドキュメントのWorking with Jetty JNDI 　参照してください。