Oracle Data Integrator で Act-On データをETL

JDBC 標準を使用して、既存のスキルを活かしながらAct-On に読み書きできます。 Oracle Data Integrator（ODI）などの ETL ツールにドロップインで統合できる CData JDBC Driver for Act-On を使えば、リアルタイムのAct-On のデータをデータウェアハウス、ビジネスインテリジェンス、ビッグデータテクノロジーに接続できます。

JDBC 接続により、ODI でAct-On を他のデータベースと同様に扱うことができます。RDBMS と同じように、フラットファイルではなくリアルタイムでAct-On API に直接接続できます。

この記事では、JDBC ベースの ETL（Act-On から Oracle へ）の手順を説明します。Act-On エンティティのデータモデルをリバースエンジニアリングした後、マッピングを作成し、データロード戦略を選択します。ドライバーが SQL-92 をサポートしているため、組み込みの SQL to SQL Loading Knowledge Module を選択するだけで簡単に実現できます。

ドライバーのインストール

ドライバーをインストールするには、インストールフォルダにあるドライバー JAR（cdata.jdbc.acton.jar）と .lic ファイル（cdata.jdbc.acton.lic）を、ODI の適切なディレクトリにコピーします。

• UNIX/Linux（エージェントなし）: ~/.odi/oracledi/userlib
• UNIX/Linux（エージェントあり）: ~/.odi/oracledi/userlib および $ODI_HOME/odi/agent/lib
• Windows（エージェントなし）: %APPDATA%\Roaming\odi\oracledi\userlib
• Windows（エージェントあり）: %APPDATA%\odi\oracledi\userlib および %APPDATA%\odi\agent\lib

ODI を再起動してインストールを完了します。

モデルのリバースエンジニアリング

モデルをリバースエンジニアリングすると、ドライバーのAct-On のデータに対するリレーショナルビューのメタデータが取得されます。リバースエンジニアリング後は、リアルタイムのAct-On のデータをクエリし、Act-On テーブルに基づいてマッピングを作成できます。

1. ODI でリポジトリに接続し、New -> Model and Topology Objects をクリックします。
2. 表示されるダイアログの Model 画面で、以下の情報を入力します。
   • Name: ActOn と入力します。
   • Technology: Generic SQL を選択します（ODI バージョン 12.2 以降の場合は Microsoft SQL Server を選択）。
   • Logical Schema: ActOn と入力します。
   • Context: Global を選択します。
   
3. 表示されるダイアログの Data Server 画面で、以下の情報を入力します。
   • Name: ActOn と入力します。
   • Driver List: Oracle JDBC Driver を選択します。
   • Driver: cdata.jdbc.acton.ActOnDriver と入力します。
   • URL: 接続文字列を含む JDBC URL を入力します。

     ActOn はOAuth 認証標準を利用しています。OAuth を使って認証するには、アプリケーションを作成してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得する必要があります。

     認証方法についての詳細は、ヘルプドキュメントの「認証の使用」を参照してください。

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

     JDBC URL の作成には、Act-On JDBC Driver に組み込まれている接続文字列デザイナーをご利用ください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。

     java -jar cdata.jdbc.acton.jar
     

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

     

     一般的な接続文字列は以下のとおりです。

     jdbc:acton:
     

   
4. Physical Schema 画面で、以下の情報を入力します。
   • Name: ドロップダウンメニューから選択します。
   • Database (Catalog): CData と入力します。
   • Owner (Schema): Act-On でスキーマを選択した場合は選択したスキーマを入力し、それ以外の場合は ActOn と入力します。
   • Database (Work Catalog): CData と入力します。
   • Owner (Work Schema): Act-On でスキーマを選択した場合は選択したスキーマを入力し、それ以外の場合は ActOn と入力します。
   
5. 開いたモデルで Reverse Engineer をクリックして、Act-On テーブルのメタデータを取得します。

Act-On のデータの編集と保存

リバースエンジニアリングが完了すると、ODI でAct-On のデータを操作できるようになります。 Act-On のデータを編集・保存するには、Designer ナビゲーターで Models アコーディオンを展開し、テーブルを右クリックして Data をクリックします。Refresh をクリックするとデータの変更を取得できます。変更が完了したら Save Changes をクリックします。

ETL プロジェクトの作成

以下の手順に従って、Act-On からの ETL を作成します。ODI Getting Started VM に含まれるサンプルデータウェアハウスに Images エンティティをロードします。

1. SQL Developer を開き、Oracle データベースに接続します。Connections ペインでデータベースのノードを右クリックし、new SQL Worksheet をクリックします。

   または、SQLPlus を使用することもできます。コマンドプロンプトから以下を入力します。

   sqlplus / as sysdba
   

2. 以下のクエリを入力して、ODI_DEMO スキーマにあるサンプルデータウェアハウスに新しいターゲットテーブルを作成します。以下のクエリでは、Act-On の Images テーブルに対応するいくつかのカラムを定義しています。

   CREATE TABLE ODI_DEMO.TRG_IMAGES (NAME NUMBER(20,0),Id VARCHAR2(255));
   

3. ODI で Designer ナビゲーターの Models アコーディオンを展開し、ODI_DEMO フォルダ内の Sales Administration ノードをダブルクリックします。モデルエディターでモデルが開きます。
4. Reverse Engineer をクリックします。TRG_IMAGES テーブルがモデルに追加されます。
5. プロジェクト内の Mappings ノードを右クリックし、New Mapping をクリックします。マッピングの名前を入力し、Create Empty Dataset オプションのチェックを外します。Mapping Editor が表示されます。
6. Sales Administration モデルから TRG_IMAGES テーブルをマッピングにドラッグします。
7. Act-On モデルから Images テーブルをマッピングにドラッグします。
8. ソースのコネクタポイントをクリックし、ターゲットのコネクタポイントにドラッグします。Attribute Matching ダイアログが表示されます。この例では、デフォルトのオプションを使用します。ターゲットカラムのプロパティにターゲット式が表示されます。
9. Mapping Editor の Physical タブを開き、TARGET_GROUP 内の IMAGES_AP をクリックします。
10. IMAGES_AP のプロパティで、Loading Knowledge Module タブの LKM SQL to SQL (Built-In) を選択します。

マッピングを実行して、Act-On のデータを Oracle にロードできます。