Denodo Platform で Adobe Target のデータに接続

Jerod Johnson
Senior Technology Evangelist

CData ドライバーを使用して、Denodo Virtual DataPort Administrator で Adobe Target のデータ用の仮想データソースを作成する方法を説明します。

Denodo Platform は、エンタープライズデータベースのデータを統合的に扱うことができるデータ仮想化製品です。CData JDBC Driver for Adobe Target と組み合わせることで、Denodo ユーザーは他のエンタープライズデータソースと並んでライブ Adobe Target のデータを扱うことができます。本記事では、Denodo Virtual DataPort Administrator で Adobe Target 用の仮想データソースを作成する方法を解説します。

CData JDBC Driver は、最適化されたデータ処理機能を内蔵しており、ライブ Adobe Target のデータとのやり取りにおいて比類のないパフォーマンスを提供します。Adobe Target に対して複雑な SQL クエリを発行すると、ドライバーはフィルターや集計などのサポートされている SQL 操作を直接 Adobe Target にプッシュし、内蔵の SQL エンジンを使用してサポートされていない操作（主に SQL 関数や JOIN 操作）をクライアントサイドで処理します。また、動的メタデータクエリ機能を内蔵しているため、ネイティブデータ型を使用して Adobe Target のデータを操作・分析できます。

Adobe Target 仮想ポートの作成

Denodo からライブ Adobe Target のデータに接続するには、JDBC Driver の JAR ファイルを Denodo の外部ライブラリディレクトリにコピーし、Virtual DataPort Administrator ツールで新しい JDBC データソースを作成します。

CData JDBC Driver for Adobe Target インストーラーをダウンロードし、パッケージを解凍して JAR ファイルを実行してドライバーをインストールします。
インストール先（通常は C:\Program Files\CData\CData JDBC Driver for Adobe Target\lib\）から JAR ファイル（およびライセンスファイルが存在する場合はそれも）を Denodo 外部ライブラリディレクトリ（C:\Denodo\Denodo Platform\lib-external\jdbc-drivers\cdata-adobetarget-19）にコピーします。
Denodo Virtual DataPort Administrator ツールを開き、Server Explorer タブに移動します。
"admin" を右クリックし、New -> Data source -> JDBC を選択します。
JDBC 接続を設定します:
- Name: 任意の名前（例: adobetarget）
- Database adapter: Generic
- Driver class path: C:\Denodo\Denodo Platform\lib-external\jdbc-drivers\cdata-adobetarget-19
- Driver class: cdata.jdbc.adobetarget.AdobeTargetDriver
- Database URI: 必要な接続プロパティを使用して JDBC URL を設定します。例:
  
  jdbc:adobetarget:Tenant=mycompanyname;
  
  Database URI の作成方法は以下のとおりです:
  
  ビルトイン接続文字列デザイナー
  
  JDBC URL の構築には、Adobe Target JDBC Driver に組み込まれた接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。
```
	java -jar cdata.jdbc.adobetarget.jar
	
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  
  Adobe Target に接続するには、以下に記載されているOAuth 接続プロパティとともにTenant プロパティを指定する必要があります。他の接続プロパティは処理動作に影響を与える可能性がありますが、接続には影響しません。
  
  以下のステップでTenant 名を確認できます。
  1. Adobe Experience にログインします。URL は「https://experience.adobe.com/#/@mycompanyname/preferences/general-section」です。
  2. 「/#/@」の後の値を抽出します。この例では「mycompanyname」です。
  3. Tenant 接続プロパティをその値に設定します。
  ユーザーアカウント（OAuth）
  
  すべてのユーザーアカウントフローでAuthScheme をOAuthClient に設定する必要があります。
  
  注意：OAuth を介したAdobe 認証では、2週間ごとにトークンを更新する必要があります。
  
  すべてのアプリケーション
  CData では、OAuth 認証を簡素化する組み込みOAuth アプリケーションを提供しています。または、カスタムOAuth アプリケーションを作成することもできます。詳細については、ヘルプドキュメントの「カスタムOAuthアプリの作成」をご確認ください。
  OAuth アクセストークンの取得
  
  接続するには以下のプロパティを設定します：
  - InitiateOAuth：GETANDREFRESH に設定して、OAuth 交換を自動的に実行し、必要に応じてOAuthAccessToken を更新します。
  - OAuthClientId：アプリを登録した際に割り当てられたクライアントID に設定します。
  - OAuthClientSecret：アプリを登録した際に割り当てられたクライアントシークレットに設定します。
  - CallbackURL：アプリを登録した際に定義されたリダイレクトURI に設定します。例：https://localhost:3333
  これらの設定により、プロバイダーはAdobe Target からアクセストークンを取得し、それを使用してデータを要求します。OAuth値はOAuthSettingsLocation で指定された場所に保存され、接続間で確実に保持されます。
"Test connection" ボタンをクリックして設定を確認し、Save をクリックします。

VirtualPort Administrator ツールで Adobe Target のデータを表示

データソースを作成したら、Denodo Platform で使用する Adobe Target のデータのベースビューを作成できます。

新しく作成した VirtualPort (admin.AdobeTarget) で "Create base view" ボタンをクリックします。
オブジェクトツリーを展開し、インポートするオブジェクト（テーブル）を選択します。
"Create selected" ボタンをクリックして、Adobe Target のデータのビューを作成します。
オプション: "Create associations from foreign keys" をクリックして、オブジェクト間のリレーションシップを定義できます。
ビューが作成されたら、Server Explorer で対象テーブル（cdata_adobetarget_activities）に移動し、選択したテーブルをダブルクリックします。
新しいタブで "Execution panel" をクリックしてクエリパネルを開きます。
"Execute" タブでクエリをカスタマイズするか、デフォルトのクエリを使用します:
```
SELECT * FROM cdata_adobetarget_activities CONTEXT ('i18n'='us_est', 'cache_wait_for_load'='true')
```
Execute をクリックしてデータを表示します。