Dremio でOracle Eloqua Reporting のデータに外部ソースとして接続
CData JDBC Driver for Oracle Eloqua Reporting はJDBC 標準を実装しており、Dremio を含むさまざまなアプリケーションでリアルタイムのOracle Eloqua Reporting のデータを扱えるようにします。Dremio は、データレイク上でのセルフサービス型インタラクティブ分析を実現するために設計されたデータレイクハウスプラットフォームです。CData JDBC ドライバーを使用することで、エンタープライズデータレイクの一部としてリアルタイムOracle Eloqua Reporting のデータを活用できます。この記事では、Dremio でOracle Eloqua Reporting のデータに外部ソースとして接続する方法について説明します。
CData JDBC Driver を使用すると、Dremio でリアルタイムOracle Eloqua Reporting のデータへの高速アクセスが可能になります。ドライバーをインストールしてOracle Eloqua Reporting で認証すれば、データレイク内でOracle Eloqua Reporting のデータにすぐにアクセスできます。ネイティブのデータ型を使用してOracle Eloqua Reporting のデータを表示し、複雑なフィルタ、集計、その他の操作を自動的に処理することで、CData JDBC Driver はOracle Eloqua Reporting のデータへのシームレスなアクセスを提供します。
前提条件
この記事では、Docker を使用して Dremio を実行することを想定しています。以下のようなコマンドで Dremio サービスを含む Docker コンテナを作成できます。
docker run -d --name dremio -p 9047:9047 -p 31010:31010 dremio/dremio-oss
ここで、dremio はコンテナの名前、9047 は Dremio Web インターフェース用のコンテナポート、31010 は Dremio クエリサービスにマッピングされるポートです。dremio/dremio-oss は使用するイメージを指定します。
ARP コネクタのビルド
CData JDBC Driver を Dremio で使用するには、Advanced Relation Pushdown(ARP)コネクタをビルドする必要があります。GitHub でソースコードを確認するか、ZIP ファイル(GitHub.com)を直接ダウンロードできます。ファイルをコピーまたは展開したら、コネクタのルートディレクトリ(pom.xml ファイルがあるディレクトリ)から以下のコマンドを実行してコネクタをビルドします。
mvn clean install
NOTE:CData ARP コネクタは Java 11 でコンパイルするようにビルドされています。Java 11 をインストールし、正しいバージョンを使用していることを確認してください。以下のようなコマンドで Java バージョンを更新できます。
sudo update-alternatives --config java
コネクタ用の JAR ファイルが(target ディレクトリに)ビルドされたら、ARP コネクタと JDBC Driver を Dremio インスタンスにコピーする準備が整いました。
コネクタと JDBC Driver のインストール
ARP コネクタを %DREMIO_HOME%/jars/ に、Oracle Eloqua Reporting 用の JDBC Driver を %DREMIO_HOME%/jars/3rdparty にインストールします。以下のようなコマンドを使用できます。
ARP コネクタ
docker cp PATH\TO\dremio-oracleeloquareporting-plugin-{DREMIO_VERSION}.jar dremio_image_name:/opt/dremio/jars/
Oracle Eloqua Reporting 用 JDBC Driver
docker cp PATH\TO\cdata.jdbc.oracleeloquareporting.jar dremio_image_name:/opt/dremio/jars/3rdparty/
Oracle Eloqua Reporting への接続
これで、Dremio の外部ソースオプションに Oracle Eloqua Reporting が表示されるようになりました。ビルドした ARP コネクタは、JDBC URL を使用してOracle Eloqua Reporting のデータに接続します。JDBC Driver には、接続文字列を作成できるビルトインの接続文字列デザイナーがあります(以下を参照)。
ビルトイン接続文字列デザイナー
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 アプリケーション登録時に割り当てられたクライアントシークレットを指定します。
NOTE:Dremio で JDBC Driver を使用するには、ライセンス(正式版または評価版)とランタイムキー(RTK)が必要です。このライセンス(または評価版)の取得については、営業チームにお問い合わせください。
ランタイムキー(RTK)を JDBC URL に追加します。最終的に、以下のような JDBC URL になります。
jdbc:oracleeloquareporting:RTK=5246...;AuthScheme=Basic;User=user;Password=password;Company=MyCompany;
Oracle Eloqua Reporting に外部ソースとしてアクセス
Oracle Eloqua Reporting を外部ソースとして追加するには、新しいソースを追加するためにクリックし、OracleEloquaReporting を選択します。JDBC URL をコピーして、New OracleEloquaReporting Source ウィザードに貼り付けます。
接続を保存すれば、Dremio でリアルタイムOracle Eloqua Reporting のデータをクエリする準備が整い、Oracle Eloqua Reporting のデータをデータレイクに簡単に取り込むことができます。
詳細情報と無償トライアル
Dremio で CData JDBC Driver for Oracle Eloqua Reporting を使用すると、リアルタイムOracle Eloqua Reporting のデータをデータレイクに取り込むことができます。Oracle Eloqua Reporting への接続の詳細については、CData JDBC Driver for Oracle Eloqua Reporting ページをご覧ください。CData JDBC Driver for Oracle Eloqua Reporting の30日間無償トライアルをダウンロードして、今すぐ始めましょう。