TIBCO Data Virtualization で Unbounce のデータ にリアルタイムアクセスする方法

TIBCO Data Virtualization（TDV）は、複数の多様なデータソースへのアクセスを一元管理するエンタープライズデータ仮想化ソリューションです。CData TIBCO DV Adapter for Unbounce と組み合わせることで、TIBCO Data Virtualization 内からUnbounce のデータに直接フェデレーテッドアクセスが可能になります。この記事では、アダプターのデプロイと Unbounce に基づく新しいデータソースの作成手順を解説します。

CData TIBCO DV Adapter は、最適化されたデータ処理機能が組み込まれており、Unbounce のデータ とのインタラクションにおいて比類のないパフォーマンスを発揮します。Unbounce に対して複雑な SQL クエリを発行すると、アダプターはフィルタや集計などサポートされている SQL 操作を直接 Unbounce にプッシュします。組み込みの動的メタデータクエリにより、ネイティブのデータ型を使用してUnbounce のデータを操作・分析できます。

Unbounce TIBCO DV Adapter のデプロイ

1. コンソールで、TDV Server のインストールディレクトリ内の bin フォルダに移動します。現在のバージョンのアダプターがインストールされている場合は、先にアンデプロイする必要があります。

   .\server_util.bat -server localhost -user admin -password ******** -undeploy -version 1 -name API
   

2. CData TIBCO DV Adapter をローカルフォルダに解凍し、解凍した場所から JAR ファイル（tdv.api.jar）をサーバーにデプロイします。

   .\server_util.bat -server localhost -user admin -password ******** -deploy -package /PATH/TO/tdv.api.jar
   

新しい JAR ファイルが正しくロードされるように、サーバーの再起動が必要な場合があります。再起動は、C:\Program Files\TIBCO\TDV Server <version>\bin にある composite.bat スクリプトを実行して行えます。サーバーを再起動した後は、TDV Studio への再認証が必要です。

再起動コマンドの例

.\composite.bat monitor restart

OAuth を使用して Unbounce で認証する

Unbounce は OAuth プロトコルを使用して認証を行いますが、TDV Studio は内部でブラウザベースの認証をサポートしていないため、OAuth トークンを取得するための簡単な Java アプリケーションを作成して実行する必要があります。取得したトークンは、アダプターから直接 Unbounce に接続するために使用されます。

以下のコードサンプルは、Unbounce での認証方法を示しています。tdv.api.jar ファイルをクラスパスに含めて Java アプリケーションを実行するだけです。

APIOAuth oauth = new APIOAuth();
oauth.generateOAuthSettingsFile("InitiateOAuth=GETANDREFRESH;" +
                                  "Profile=C:\profiles\Unbounce.apip;Authscheme=OAuth;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;" +
                                  "OAuthSettingsLocation=C:\api\OAuthSettings.txt;");

アダプターをデプロイして認証が完了したら、TDV Studio で Unbounce 用の新しいデータソースを作成できます。

TDV Studio で Unbounce データソースを作成する

CData TIBCO DV Adapter for Unbounce を使用すると、Unbounce 用のデータソースを簡単に作成し、データソースをイントロスペクトしてリソースを TDV に追加できます。

データソースの作成

1. データソースを追加するフォルダを右クリックし、New -> New Data Source を選択します。
2. アダプター（例：Unbounce）が表示されるまでスクロールし、Next をクリックします。
3. データソースに名前を付けます（例：CData Unbounce Source）。

4. 必要な接続プロパティを入力します。

   まず、Profile 接続プロパティにUnbounce プロファイルのディスク上の場所を設定します（例：C:\profiles\Unbounce.apip）。

   次に、ProfileSettings 接続プロパティにUnbounce の接続文字列を設定します（以下を参照）。

   Unbounce API プロファイル設定

   Unbounce はOAuth を使用してデータに認証します。

   Unbounce に認証するには、まずOAuth アプリケーションを登録する必要があります。https://developer.unbounce.com/getting_started/ にアクセスし、Register OAuth Application フォームを完了します。

   以下の接続プロパティを設定すると、接続の準備が整います：

   • AuthScheme：OAuth に設定します。
   • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。
   • OAuthClientId：アプリ設定で指定されているClient Id を設定します。
   • OAuthClientSecret：アプリ設定で指定されているClient Secret を設定します。
   • CallbackURL：アプリ設定で指定したRedirect URI を設定します。

   NOTE：DV Adapter の OAuthSettingsLocation プロパティには、OAuth 認証（上記参照）を実行したときと同じ値を設定してください。

   
5. Create & Close をクリックします。

データソースのイントロスペクト

データソースを作成したら、右クリックして Open を選択することでデータソースをイントロスペクトできます。ダッシュボードで Add/Remove Resources をクリックし、データソースの一部として含めるテーブル、ビュー、ストアドプロシージャを選択します。Next をクリックし、Finish をクリックして、選択した Unbounce のテーブル、ビュー、ストアドプロシージャをリソースとして追加します。

データソースを作成してイントロスペクトしたら、他のリレーショナルデータソースと同様に TIBCO Data Virtualization でUnbounce のデータを操作できるようになります。ビューの作成、SQL によるクエリ、データソースの公開など、さまざまな操作が可能です。