Oracle E-Business Suiteをデータパイプラインのソースとして構成する
Oracle E-Business Suite(EBS)をデータパイプラインのソースとして設定し、EBSデータベーステーブルから宛先にレコードを抽出および同期します。パイプラインはオンプレミスエージェントを介してEBSデータベースに直接接続します。
このガイドを使用して、データベースユーザーの設定、EBSへの接続、パイプラインの構成、同期動作、データ型の処理、および制限事項を確認します。
Oracle E-Business Suiteでサポートされる機能
Oracle E-Business Suiteをパイプラインソースとして使用する場合、次の機能がサポートされます。
- オンプレミス接続: オンプレミスグループを介してEBSデータベースに接続します。 Cloudコネクションはサポートされていません。
- フル同期と増分同期: 各実行ですべての行を同期するか、変更追跡カラムに基づいて新規および更新済みの行のみを同期します。詳細については、同期モードを参照してください。
- テーブル単位のオブジェクト選択: データベースユーザーがアクセスできる任意のスキーマから個々のテーブルを選択します。
- プライマリキーの検出: データベース制約およびEBSテーブルメタデータからプライマリキーを検出します。詳細については、Primary keysを参照してください。
- 削除の追跡: テーブルがフル同期モードで実行されている場合、ソースで削除されたレコードを宛先でも削除済みとしてマークします。
- スキーマドリフトの検出と処理: 新しいフィールドを自動同期でスキーマの変更を自動的に検出して適用するか、新しいフィールドをブロックでスキーマを固定します。
- フィールドレベルのデータ保護:データがデスティネーションに到達する前に、機密フィールドをハッシュ化するか、そのままレプリケートします。
- 構成可能な同期頻度: 時間ベースの間隔またはcron式を使用して同期をスケジュールします。サポートされる最小間隔は15分です。
Oracle E-Business Suiteの前提条件
Oracle E-Business Suiteをデータパイプラインのソースとして接続するには、次の要件があります。
- オンプレミスエージェントホストから到達可能なOracle EBSデータベース
- バージョン31.0以降で動作しているオンプレミスエージェント。設定手順については、オンプレミスエージェントのドキュメントを参照してください。
- 同期を予定しているEBSテーブルに対して
SELECTアクセス権を持つデータベースユーザー。必要な権限については、Set up a database userを参照してください。 - EBSデータベースのデータベースホスト、ポート、サービス名、ユーザー名、パスワード
データベースユーザーの設定
パイプライン用のデータベースユーザーは、同期を予定している各テーブルに対してSELECT権限を持っている必要があります。データベース管理者は既存のユーザーを使用するか、新しいユーザーを作成できます。以下の例のWORKATOを、ユーザーの名前に置き換えてください。
ユーザーを作成し、ログインアクセスを付与します。
CREATE USER WORKATO IDENTIFIED BY <password>;
GRANT CONNECT TO WORKATO;パイプラインでオブジェクトとして追加する予定の各テーブルに対して、SELECT権限を付与します。
GRANT SELECT ON <schema>.<table_name> TO WORKATO;パイプラインは次のエラーで失敗します: Table '<SCHEMA>.<TABLE_NAME>' is not available. It may have been deleted, or your credentials lack permission to access it というエラーで失敗します。
APPLSYSスキーマ内の次のEBSメタデータテーブルに対してSELECT権限を付与します。
GRANT SELECT ON APPLSYS.FND_TABLES TO WORKATO;
GRANT SELECT ON APPLSYS.FND_PRIMARY_KEYS TO WORKATO;
GRANT SELECT ON APPLSYS.FND_PRIMARY_KEY_COLUMNS TO WORKATO;
GRANT SELECT ON APPLSYS.FND_COLUMNS TO WORKATO;Workatoは、データベースにプライマリキー、一意制約、または一意インデックスが存在しないテーブルのプライマリキーを検出するために、これらのテーブルを読み取ります。データベースキーのないテーブルは、ユーザーがこれらのテーブルを読み取れない場合、Error running query on agentというエラーで読み込みに失敗します。詳細については、Primary keysを参照してください。
サポートされるコネクションタイプ
Oracle E-Business Suiteのデータパイプラインは、オンプレミスグループを介したユーザー名とパスワード認証をサポートします。
データパイプラインはOracle E-Business Suite (Data Pipelines)コネクタを使用し、EBSデータベースから直接読み取ります。レシピ用にOracle E-Business Suiteコネクタで作成したコネクションは、Integrated SOA Gateway RESTサービスを使用しており、パイプラインのソースとしては使用できません。パイプライン用に別のコネクションを作成する必要があります。
クラウドコネクションはサポートされていません
コネクションタイプフィールドでオンプレミスグループを選択する必要があります。 Cloudを選択すると、コネクションフォームにデータベースフィールドは表示されません。
Oracle E-Business Suiteに接続する
Oracle E-Business Suiteをデータパイプラインのソースとして接続するには、次の手順を実行します。
作成 > コネクションを選択するか、Cを2回押します。
Oracle E-Business Suite (Data Pipelines)を検索し、アプリとして選択します。
コネクション名フィールドに名前を入力します。
ロケーションドロップダウンメニューを使用して、コネクションを保存するプロジェクトを選択します。
Connection typeドロップダウンメニューを使用して、EBSデータベースに到達できるオンプレミスグループを選択します。
Service nameフィールドに、EBSデータベースのサービス名を入力します。
Database hostフィールドに、EBSデータベースのホストアドレスを入力します。
データベースポートフィールドにポート番号を入力します。デフォルトのOracleポートは1521です。
User nameフィールドに、Set up a database userで設定したデータベースユーザーのユーザー名を入力します。
Passwordフィールドにパスワードを入力します。
任意。スキーマフィールドにスキーマを入力します。
接続を選択して、コネクションを検証して保存します。
パイプラインの設定
Oracle E-Business Suiteをデータパイプラインのソースとして構成するには、次の手順を実行します。
作成 > データパイプラインを選択するか、C+Iを押します。
データパイプライン名フィールドにデータパイプラインの名前を入力します。
データパイプライン設定
ロケーションドロップダウンメニューを使用して、データパイプラインを保存するプロジェクトを選択します。
ビルドを開始をクリックします。
Extract new/updated records from source app トリガーをクリックします。このトリガーは、パイプラインがOracle E-Business Suiteからデータを取得する方法を定義します。
ソースアプリから新規/更新済みレコードを抽出トリガーを設定
Your Connected Source Appsドロップダウンメニューを使用して、Oracle E-Business Suite (Data Pipelines)を選択します。
このパイプラインで使用する予定のOracle E-Business Suiteコネクションを選択します。または、+ 新規コネクションをクリックして、新しいコネクションを作成します。
オブジェクトを追加をクリックして、新しいオブジェクトを追加パネルを開きます。
利用可能なEBSテーブルの一覧を検索または参照し、同期するテーブルを選択してAddをクリックします。
選択した各オブジェクトのスキーマを確認してカスタマイズします。パイプラインは、オブジェクトを選択するとそのオブジェクトのスキーマを自動的に取得します。これにより、デスティネーションがソースと一致します。
オブジェクトを展開して、関連フィールドを表示します。使用可能なすべてのデータを抽出するにはすべてのフィールドを選択したままにし、データ抽出とスキーマレプリケーションから除外するには特定のフィールドの選択を解除します。
任意。テーブルの横にある歯車アイコンをクリックしてSync mode設定を開き、Sync modeドロップダウンメニューでFull syncまたはIncrementalを選択し、Saveをクリックします。
同期モードは、すべてのテーブルでデフォルトでIncrementalに設定されています。既定の変更追跡カラムのいずれも持たないテーブルでは、増分同期は失敗します。これらのテーブルについては、Change tracking columnフィールドでカラムを選択するか、Full syncを選択します。
Sync modeまたはChange tracking columnを変更すると、次回のパイプライン実行時に、そのテーブルのフル再同期がトリガーされます。
任意。オブジェクトを展開し、各フィールドの処理方法を選択して、フィールドレベルのデータ保護を設定します。
- そのまま複製: ソースのデータ値が宛先に同一に複製されます。
- ハッシュ: 宛先に同期する前に、フィールド内の機密データ値をハッシュ化します。
Workatoでは、個人を特定できる情報(PII)やその他の機密フィールドをハッシュ化することを推奨します。
オブジェクトを追加を再度クリックして、さらにオブジェクトを追加します。この手順を繰り返して、パイプラインにOracle E-Business Suiteのオブジェクトをさらに追加します。
スキーマ変更の処理方法を選択ドロップダウンメニューを使用して、スキーマドリフトの処理オプションを選択します。
- 新しいフィールドを自動同期: ソースに追加された新しいフィールドを自動的に検出して同期します。
- 新しいフィールドをブロック: パイプラインの開始後、スキーマを固定します。新しいフィールドは手動で追加する必要があります。このオプションを使用すると、ソーススキーマが更新された場合に宛先が同期されなくなる可能性があります。
詳細については、スキーマのレプリケーションとスキーマドリフトの管理を参照してください。
Frequency(頻度)フィールドで、標準の時間ベースのスケジュールを選択するか、カスタムcron式を定義します。これにより、パイプラインがOracle E-Business Suiteから送信先にデータを同期する頻度が決まります。
開始日設定は、変更追跡カラムを持つテーブルにのみ適用されます。詳細については、完全同期を参照してください。
サポートされるOracle E-Business Suiteオブジェクト
Oracle E-Business Suiteデータパイプラインは、接続されたEBSデータベース内のテーブルからデータを同期します。 Add objectをクリックすると、Workatoはデータベースユーザーがアクセスできるすべてのスキーマにわたる全テーブルを一覧表示します。各テーブルは<SCHEMA>.<TABLE_NAME>として表示され、宛先では個別のテーブルとして同期されます。
テーブルのみが一覧表示されます。ビューとシノニムはオブジェクトとして使用できません。
主キー
Workatoは、各テーブルのプライマリキーを次の順序で特定します。
- データベース制約: テーブルの有効なプライマリキーまたは一意制約、または一意インデックス。
- EBSメタデータ: EBSの
FND_PRIMARY_KEYSメタデータテーブルに登録されているテーブルのプライマリキー。 Workatoがこのメタデータを読み取れるのは、データベースユーザーがSet up a database userで挙げたAPPLSYSテーブルにアクセスできる場合のみです。 - ROWID: いずれのソースでもプライマリキーが明示的に定義されていない場合、Workatoは
ROWIDカラムをプライマリキーとして追加します。これが同期に与える影響については、Tables keyed by ROWIDを参照してください。
同期モード
Oracle E-Business Suiteデータパイプラインは、フル同期と増分同期をサポートします。同期モードは、テーブルをパイプラインに追加する際にテーブルごとに構成されます。
フル同期
フル同期では、パイプライン実行のたびにソーステーブルを読み取ります。変更追跡カラムを持たないテーブルには、フル同期を使用してください。大規模なEBSテーブルのフル同期は、増分同期よりも時間とリソースを多く消費する可能性があります。
フル同期で読み取られる行は、When first started, this pipeline should pick up records fromフィールドで指定したパイプライン開始日に依存します。
- 変更追跡カラムを持つテーブル: フル同期は、変更追跡値が開始日以降の行のみを読み取ります。変更追跡値がそれより前、またはnullの行は同期されず、削除の追跡によって削除済みとしてマークされることもありません。開始日を空のままにした場合、フル同期はすべての行を読み取ります。
- 変更追跡カラムを持たないテーブル: フル同期は、開始日に関係なくすべての行を読み取ります。
増分同期
増分同期では、前回の実行以降に変更追跡カラムの値が変更された行のみを読み取ります。増分テーブルの最初の実行はフル同期として動作します。 Workatoは次のカラムをこの順序で確認し、テーブル内に存在する最初のカラムを既定の変更追跡カラムとして選択します。
LAST_UPDATE_DATEUPDATEDLAST_MODIFIED_DATE
テーブルの同期設定内のChange tracking columnフィールドで、別のカラムを選択できます。既定のカラムがいずれも存在せず、かついずれのカラムも選択されていないテーブルでは、増分同期は失敗します。これらのテーブルには変更追跡カラムを選択するか、フル同期に切り替えてください。同期設定手順については、Configure the pipelineを参照してください。
増分同期では、変更追跡カラムが変更された場合にのみ、変更された行を検出します。変更追跡値が更新されない更新行や、変更追跡値がnullの行は、増分同期では検出されません。
削除追跡
削除の追跡は同期モードに依存します。
- フル同期: Workatoは、次回のフル同期時に、ソースで削除されたレコードを宛先でも削除済みとしてマークします。
- 増分同期: 各実行では新しい変更追跡値を持つ行のみを読み取るため、削除は検出されません。
スキーマとデータ型の処理
WorkatoはOracleカラム型を次のように宛先の型にマッピングします。
| Oracleタイプ | 同期後の型 |
|---|---|
NUMBER, INTEGER, INT, SMALLINT, DECIMAL, NUMERIC | 小数 |
FLOAT, BINARY_FLOAT, BINARY_DOUBLE | Double |
BOOLEAN | ブーリアン |
DATE, TIMESTAMP | タイムゾーンなしタイムスタンプ |
TIMESTAMP WITH TIME ZONE, TIMESTAMP WITH LOCAL TIME ZONE | タイムゾーン付きタイムスタンプ |
CHAR, NCHAR, VARCHAR2, NVARCHAR2, LONG, ROWID | 文字列 |
CLOB, NCLOB, XMLTYPE, RAW, LONG RAW, BLOB | 宛先の最大文字列長を使用した文字列 |
INTERVAL型、SDO_GEOMETRY、その他の型 | 文字列 |
数値カラムに精度が宣言されていない場合、スケールが負の値の場合、精度が38を超える場合、またはスケールが宣言された精度を超える場合、数値カラムは小数ではなく文字列として同期されます。 OracleのDATEカラムは時刻情報を含み、タイムスタンプとして同期されます。
Oracle E-Business Suiteの制限事項
Oracle E-Business Suiteをデータパイプラインのソースとして使用する場合、次の制限が適用されます。
ROWIDでキー付けされたテーブル
Workatoは、データベースまたはEBSメタデータにプライマリキーを持たないテーブルについて、ROWIDをプライマリキーとして使用します。これらのテーブルをパイプラインに追加すると、スキーマ内にROWIDフィールドが表示されます。 ROWIDはOracleが行を物理的に保存している場所を表すため、行の内容が変わらなくても、行がディスク上で移動すると変更される可能性があります。詳細については、OracleのROWID pseudocolumnドキュメントを参照してください。
フル同期の実行中に行のROWIDが変更された場合、その行を取りこぼす可能性があります。フル同期を使用しているテーブルであれば、次回の実行時にテーブル全体を再度読み取るため、その行が取り込まれます。変更追跡カラムが変更されない限り、増分同期では取りこぼされた行は検出されません。 object re-syncを実行して、そのテーブルの最新データを宛先に読み込みます。
ROWIDテーブルにはフル同期を使用すること
テーブル行がディスク上で移動する可能性が不明な場合は、ROWIDでキー付けされたテーブルにはフル同期を使用してください。
最小同期頻度
サポートされる最小同期間隔は15分です。
最終更新日: