DBeaver からOracle Eloqua Reporting のデータに連携して可視化する方法とは？

CData JDBC Driver for OracleEloquaReporting は、IDE からBI ツールまで、サードパーティーツールからOracle Eloqua Reporting のデータの読み書きを可能にするJDBC 標準を提供します。本記事では、DBeaver のウィザードを使ってOracle Eloqua Reporting のデータに接続し、GUI 上でデータを参照する方法を紹介します。

CData JDBC ドライバとは？

CData JDBC ドライバは、以下の特徴を持ったリアルタイムデータ接続ツールです。

1. Oracle Eloqua Reporting をはじめとする、CRM、MA、グループウェア、広告、会計ツールなど多様な270種類以上のSaaS / DB に対応
2. DBeaver を含む多様なアプリケーション、ツールにOracle Eloqua Reporting のデータを連携
3. ノーコードでの手軽な接続設定
4. 標準 SQL での柔軟なデータ読み込み・書き込み

CData JDBC ドライバでは、1.データソースとしてOracle Eloqua Reporting の接続を設定、2.DBeaver 側でJDBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData JDBC ドライバのインストールとOracle Eloqua Reporting への接続設定

まずは、本記事右側のサイドバーからOracleEloquaReporting JDBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

次に、以下の手順でDBeaver にドライバーのJAR ファイルをロードします。

1. DBeaver アプリケーションを開き、「データベース」メニューの「ドライバーマネジャー」オプションを選択します。「新規」をクリックして「新しいドライバを作成する」フォームを開きます。
2. 設定タブで：
   • ドライバ名をわかりやすい名前に設定します（例：CData JDBC Driver for Oracle Eloqua Reporting）。
   • クラス名をJDBC ドライバーのクラス名「cdata.jdbc.oracleeloquareporting.OracleEloquaReportingDriver」に設定します。
   • URL テンプレートをjdbc:oracleeloquareporting: に設定します。
   
3. ライブラリタブで「ファイルを追加」をクリックし、インストールディレクトリ（C:\Program Files\CData\CData JDBC Driver for Oracle Eloqua Reporting XXXX\）の「lib」フォルダに移動してJAR ファイル（cdata.jdbc.OracleEloquaReporting.jar）を選択します。

Oracle Eloqua Reporting のデータの接続を作成

以下の手順で、認証情報およびその他の必要な接続プロパティを追加します。

1. 「データベース」メニューで、「新しい接続」をクリックします。
2. 表示される「新しい接続を作成する」 ウィザードで、先ほど作成したドライバー（例：CData JDBC Driver for Oracle Eloqua Reporting）を選択し、「次へ >」をクリックします。
3. 設定ウィザードの一般タブで、以下を参考に必要な接続プロパティを使用してJDBC URL を設定します。

   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 アプリケーション登録時に割り当てられたクライアントシークレットを指定します。

   組み込みの接続文字列デザイナー

   JDBC URL の作成の補助として、Oracle Eloqua Reporting JDBC Driver に組み込まれている接続文字列デザイナーが使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

   java -jar cdata.jdbc.oracleeloquareporting.jar
   

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

   

   一般的な接続文字列：

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

   
4. 「テスト接続」をクリックして、接続が正しく設定されていることを確認します。
5. 「終了」をクリックします。

Oracle Eloqua Reporting のデータにクエリを実行

これで、接続できたことで公開されたテーブルのデータにクエリを実行できるようになりました。テーブルを右クリックし、「ビュー表」をクリックします。「データ」タブでデータを確認できます。

おわりに