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

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

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

Zoom 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 を使用して Zoom で認証する

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

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

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

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

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

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

データソースの作成

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

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

   まず、Profile 接続プロパティにZoom プロファイルのディスク上の場所を設定します（例：C:\profiles\Zoom.apip）。次に、ProfileSettings 接続プロパティにZoom の接続文字列を設定します（以下を参照）。

   Zoom API プロファイル設定

   Zoom に認証するには、OAuth 標準を使用して自分のデータに接続したり、他のユーザーが自分のデータに接続できるようにします。

   まず、OAuth アプリを作成します。https://marketplace.zoom.us/develop/create に移動し、OAuth セクションのCreate をクリックします。アプリが個々のユーザー用かアカウント全体用かを選択し、アプリを公開するためのボックスのチェックを外します。アプリに名前を付けてCreate をクリックします。その後、Client Secret とClient ID が提供されます。

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

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

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

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

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

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

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