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

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

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

Outreach.io TIBCO DV Adapter のデプロイ

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

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

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

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

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

再起動コマンドの例

.\composite.bat monitor restart

OAuth を使用して Outreach.io で認証する

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

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

OutreachOAuth oauth = new OutreachOAuth();
oauth.generateOAuthSettingsFile("InitiateOAuth=GETANDREFRESH;" +
                                  "" +
                                  "OAuthSettingsLocation=C:\outreach\OAuthSettings.txt;");

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

TDV Studio で Outreach.io データソースを作成する

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

データソースの作成

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

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

   OAuth を使用してOutreach で認証する必要があります。InitiateOAuth 接続プロパティを"GETANDREFRESH" に設定します。詳しくは、ヘルプドキュメントの「OAuth 認証の使用」セクションを参照してください。

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

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

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

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

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