Denodo Platform で Oracle Eloqua Reporting のデータ に接続

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

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

Oracle Eloqua Reporting 仮想ポートの作成

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

1. CData JDBC Driver for Oracle Eloqua Reporting インストーラーをダウンロードし、パッケージを解凍して JAR ファイルを実行してドライバーをインストールします。
2. インストール先（通常は C:\Program Files\CData\CData JDBC Driver for Oracle Eloqua Reporting\lib\）から JAR ファイル（およびライセンスファイルが存在する場合はそれも）を Denodo 外部ライブラリディレクトリ（C:\Denodo\Denodo Platform\lib-external\jdbc-drivers\cdata-oracleeloquareporting-19）にコピーします。
3. Denodo Virtual DataPort Administrator ツールを開き、Server Explorer タブに移動します。
4. "admin" を右クリックし、New -> Data source -> JDBC を選択します。
5. JDBC 接続を設定します:
   • Name: 任意の名前（例: oracleeloquareporting）
   • Database adapter: Generic
   • Driver class path: C:\Denodo\Denodo Platform\lib-external\jdbc-drivers\cdata-oracleeloquareporting-19
   • Driver class: cdata.jdbc.oracleeloquareporting.OracleEloquaReportingDriver

   • Database URI: 必要な接続プロパティを使用して JDBC URL を設定します。例:

     jdbc:oracleeloquareporting:AuthScheme=Basic;User=user;Password=password;Company=MyCompany;

     

     Database URI の作成方法は以下のとおりです:

     ビルトイン接続文字列デザイナー

     JDBC URL の構築には、Oracle Eloqua Reporting JDBC Driver に組み込まれた接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行してください。

     	java -jar cdata.jdbc.oracleeloquareporting.jar
     	

     接続プロパティを入力し、接続文字列をクリップボードにコピーします。

     Oracle Eloqua Reporting では、以下の認証方法に対応しています。

     • Basic 認証（ユーザーとパスワード）
     • OAuth 2.0 コードグラントフロー
     • OAuth 2.0 パスワードグラントフロー

     Basic 認証（ユーザーとパスワード）

     ユーザーとパスワードで認証するには、以下のプロパティを設定します。

     • AuthScheme: Basic を指定します。
     • Company: Oracle Eloqua Reporting アカウントに関連付けられた会社名を指定します。
     • User: ログインアカウント名を指定します。
     • Password: ログインパスワードを指定します。

     OAuth 認証（コードグラントフロー）

     OAuth コードグラントフローで認証するには、AuthScheme を OAuth に設定し、カスタム OAuth アプリケーションを作成します。カスタム OAuth アプリケーションの作成方法については、ヘルプドキュメントをご参照ください。

     続いて、以下のプロパティを設定します。

     • InitiateOAuth: GETANDREFRESH を指定します。OAuthAccessToken の自動取得と更新に使用します。
     • OAuthClientId: アプリケーション登録時に割り当てられたクライアント ID を指定します。
     • OAuthClientSecret: アプリケーション登録時に割り当てられたクライアントシークレットを指定します。
     • CallbackURL: アプリケーション登録時に定義したリダイレクト URI を指定します。

     接続すると、デフォルトブラウザで Oracle Eloqua Reporting の OAuth エンドポイントが開きます。ログインしてアプリケーションに権限を付与してください。アクセストークンの有効期限が切れると、ドライバーが自動的に更新します。

     OAuth 認証（パスワードグラントフロー）

     OAuth パスワードグラントフローでは、OAuth アプリケーションの資格情報とユーザー資格情報を組み合わせて認証できます。ブラウザでの手動による権限付与は必要ありません。この認証方法を使用するには、OAuth アプリを作成する必要があります（ヘルプドキュメントを参照）。

     以下のプロパティを設定します。

     • AuthScheme: OAuthPassword を指定します。
     • Company: 会社の一意の識別子を指定します。
     • User: ログインアカウント名を指定します。
     • Password: ログインパスワードを指定します。
     • OAuthClientId: カスタム OAuth アプリケーション登録時に割り当てられたクライアント ID を指定します。
     • OAuthClientSecret: カスタム OAuth アプリケーション登録時に割り当てられたクライアントシークレットを指定します。
     
6. "Test connection" ボタンをクリックして設定を確認し、Save をクリックします。

VirtualPort Administrator ツールで Oracle Eloqua Reporting のデータ を表示

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

1. 新しく作成した VirtualPort (admin.OracleEloquaReporting) で "Create base view" ボタンをクリックします。
2. オブジェクトツリーを展開し、インポートするオブジェクト（テーブル）を選択します。
3. "Create selected" ボタンをクリックして、Oracle Eloqua Reporting のデータ のビューを作成します。
   オプション: "Create associations from foreign keys" をクリックして、オブジェクト間のリレーションシップを定義できます。
4. ビューが作成されたら、Server Explorer で対象テーブル（cdata_oracleeloquareporting_）に移動し、選択したテーブルをダブルクリックします。
5. 新しいタブで "Execution panel" をクリックしてクエリパネルを開きます。
6. "Execute" タブでクエリをカスタマイズするか、デフォルトのクエリを使用します:

   SELECT * FROM cdata_oracleeloquareporting_ CONTEXT ('i18n'='us_est', 'cache_wait_for_load'='true')
   

   
7. Execute をクリックしてデータを表示します。

ベースビューの作成後は、Denodo Platform の他のデータソースと同様にライブ Oracle Eloqua Reporting のデータ を扱うことができます。たとえば、Denodo Data Catalog で Oracle Eloqua Reporting をクエリできます。

CData JDBC Driver for Oracle Eloqua Reporting の 30日間無料トライアルをダウンロードして、Denodo Platform でライブ Oracle Eloqua Reporting のデータ の活用を始めましょう。ご不明な点がございましたら、サポートチーム までお問い合わせください。