7.3 統合キャプチャ・モードでのプライマリExtractの構成

プライマリExtractがログマイニング・サーバーからログ変更のレコードをキャプチャするマイニング・データベースは、ローカルまたはソース・データベースからダウンストリームのいずれかが可能です。次の手順では、いずれかの場所から統合モードでトランザクション・データをキャプチャするようにプライマリExtractを構成します。ダウンストリーム・マイニング・データベースからのキャプチャの詳細は、「ダウンストリーム・マイニング・データベースの構成」および「ダウンストリーム・マイニング構成の例」を参照してください。

注意:

マルチテナント・コンテナ・データベース内の単一データベースまたは複数のプラガブル・データベースからキャプチャするには、一般的に1つのExtractグループで十分です。「マルチテナント・コンテナ・データベースでのOracle GoldenGateの構成」を参照してください。

ソース・システムのGGSCIで、Extractパラメータ・ファイルを作成します。
```
EDIT PARAMS name
```
説明: nameは、プライマリExtractの名前です。

次に示す順序でExtractパラメータを入力します。パラメータ文ごとに新しい行を開始します。通常のデータベースおよびマルチテナント・コンテナ・データベースの例を示します。2つの違いは、TABLEおよびSEQUENCE指定の2つの部分からなるオブジェクト名を使用する必要があるか、または3つの部分からなるオブジェクト名を使用する必要があるかです。詳細およびパラメータの説明は、表7-1を参照してください。

マイニング・データベースがダウンストリーム・データベースであり、FETCHに使用されるソースADGを備える通常のデータベースの場合のExtractの基本的なパラメータ

EXTRACT financep
USERIDALIAS tiger1
LOGALLSUPCOLS
UPDATERECORDFORMAT COMPACT
DDL INCLUDE MAPPED
ENCRYPTTRAIL AES192
EXTTRAIL /ggs/dirdat/lt
SEQUENCE hr.employees_seq;
TABLE hr.*;

マイニング・データベースがダウンストリーム・データベースであり、FETCHに使用されるソースADGを備えるマルチテナント・コンテナ・データベースの場合のExtractの基本的なパラメータ

EXTRACT financep
USERIDALIAS tiger1
LOGALLSUPCOLS
UPDATERECORDFORMAT COMPACT
DDL INCLUDE MAPPED SOURCECATALOG pdb1 INCLUDE MAPPED SOURCECATALOG pdb2
ENCRYPTTRAIL AES192
EXTTRAIL /ggs/dirdat/lt
TABLE test.ogg.tab1;
SOURCECATALOG pdb1
SEQUENCE hr.employees_seq;
TABLE hr.*;
SOURCECATALOG pdb2
TABLE sales.*;
TABLE acct.*;

マイニング・データベースがダウンストリーム・データベースおよび通常のデータベースの場合のExtractの基本的なパラメータ

EXTRACT financep
USERIDALIAS tiger1 
TRANLOGOPTIONS MININGUSERALIAS tiger2 
TRANLOGOPTIONS INTEGRATEDPARAMS (MAX_SGA_SIZE 164, & 
   DOWNSTREAM_REAL_TIME_MINE y)
LOGALLSUPCOLS
UPDATERECORDFORMAT COMPACT
DDL INCLUDE MAPPED
ENCRYPTTRAIL AES192
EXTTRAIL /ggs/dirdat/lt
SEQUENCE hr.employees_seq;
TABLE hr.*;

マイニング・データベースがダウンストリーム・データベースおよびマルチテナント・コンテナ・データベースの場合のプライマリExtractの基本的なパラメータ

EXTRACT financep
USERIDALIAS tiger1 
TRANLOGOPTIONS MININGUSERALIAS tiger2 
TRANLOGOPTIONS INTEGRATEDPARAMS (MAX_SGA_SIZE 164, & 
   DOWNSTREAM_REAL_TIME_MINE y)
LOGALLSUPCOLS
UPDATERECORDFORMAT COMPACT
DDL INCLUDE MAPPED SOURCECATALOG pdb1 INCLUDE MAPPED SOURCECATALOG pdb2
ENCRYPTTRAIL AES192EXTTRAIL /ggs/dirdat/lt
TABLE test.ogg.tab1;
SOURCECATALOG pdb1
SEQUENCE hr.employees_seq;
TABLE hr.*;
SOURCECATALOG pdb2
TABLE sales.*;
TABLE acct.*;

表7-1 統合キャプチャ・モードでのプライマリExtractの基本的なパラメータ

パラメータ	説明
EXTRACT `group`	`group`は、Extractグループの名前です。詳細は、『Oracle GoldenGate for Windows and UNIXリファレンス』を参照してください。
USERIDALIAS `alias`	Extractに割り当てられるユーザーのデータベース・ログイン資格証明の別名を指定します。この資格証明は、Oracle GoldenGate資格証明ストアに存在する必要があります。詳細は、「Oracle GoldenGate資格証明の確立」を参照してください。
`LOGALLSUPCOLS`	競合検出および解決に必要な列、統合Replicatのサポートに必要なスケジューリング列を含む、証跡に補足的にログに記録されるすべての列を書き込みます。(スケジューリング列は、主キー、一意索引および外部キー列です。)これらの列をGGSCIコマンドでログに記録するようにデータベースを構成します。「ロギング・プロパティの構成」を参照してください。
`UPDATERECORDFORMAT COMPACT`	`UPDATE`操作の変更前および変更後のイメージを証跡の単一レコードに結合します。このパラメータは、Oracle Databaseバージョン12c以上で有効で、統合モードのReplicatをサポートします。必須パラメータではありませんが、`UPDATERECORDFORMAT COMPACT`がベスト・プラクティスで、Replicatパフォーマンスを大幅に改善します。詳細は、Oracle GoldenGateリファレンスfor Windows and UNIXを参照してください。
`TRANLOGOPTIONS MININGUSERALIAS` `alias`	ダウンストリーム・マイニング・データベース(使用する場合)で、ログマイニング・サーバーの接続情報を指定します。 `MININGUSERALIAS`では、ダウンストリーム・マイニング・データベースのExtractユーザーの別名を指定します。これは、「ダウンストリーム・マイニング・データベースの構成」で作成したユーザーです。このユーザーの資格証明は、Oracle GoldenGate資格証明ストアに格納する必要があります。詳細は、Oracle GoldenGateの管理for Windows and UNIXを参照してください。データベース・ログマイニング・サーバーがソース・データベースと異なるデータベースにある場合にのみ`MININGUSERALIAS`を使用し、そうでない場合は`USERIDALIAS`を使用します。`MININGUSERALIAS`を使用する場合、両方のデータベースで資格証明が必要なため、`USERIDALIAS`とともに使用します。
TRANLOGOPTIONS [INTEGRATEDPARAMS (`parameter`[, ...])]	(オプション)データベース・ログマイニング・サーバーを含むOracle Databaseにパラメータを渡します。ログマイニング・サーバー・パラメータをデフォルト設定から変更する場合にのみ使用します。「統合キャプチャ用のその他のパラメータ・オプション」を参照してください。
`TRANLOGOPTIONS CHECKPOINTRETENTIONTIME` `days`	(オプション)チェックポイントが自動的にパージされるまでExtractが保持する日数を制御します。部分的な日数は、10進値を使用して指定されます。たとえば、8.25は8日と6時間を指定します。詳細は、『Oracle GoldenGate for Windows and UNIXリファレンス』を参照してください。
`DDL` `include_clause`	DDL操作をレプリケートする場合に必要です。詳細は、「DDLサポートの構成」を参照してください。
ENCRYPTTRAIL `algorithm`	ローカル証跡を暗号化します。Oracle GoldenGateの証跡暗号化オプションの詳細は、Oracle GoldenGate Oracle GoldenGateの管理for Windows and UNIXを参照してください。
EXTTRAIL `pathname`	プライマリExtractによってキャプチャされたデータが書き込まれるローカル証跡のパス名を指定します。詳細は、『Oracle GoldenGate for Windows and UNIXリファレンス』を参照してください
`SOURCECATALOG` `container`	このパラメータは、ソース・データベースがマルチテナント・コンテナ・データベースの場合に使用します。2つの部分からなる名前を含む後続のすべての`TABLE`および`SEQUENCE`パラメータで、デフォルトのコンテナとして使用されるプラガブル・データベースの名前を指定します。このパラメータでは、3つの部分からなる名前(`container.schema.object`)ではなく、2つの部分からなるオブジェクト名(`schema.object`)を使用できます。別の`SOURCECATALOG`パラメータが発生するか、3つの部分からなる完全な`TABLE`または`SEQUENCE`指定が発生するまで実質的に保持されます。
{TABLE \| SEQUENCE} `[container.]schema.object`;	データをキャプチャするデータベース・オブジェクトを指定します。 `TABLE`は、表または表のワイルドカード・セットを指定します。 `SEQUENCE`は、順序または順序のワイルドカード・セットを指定します。 `container`は、オブジェクトを格納するプラガブル・データベース(PDB)の名前です(このデータベースがマルチテナント・コンテナ・データベースの場合)。このExtractグループが1つのPDBからのデータのみを処理し、デフォルトのPDBが`SOURCECATALOG`パラメータで指定されている場合、名前のコンテナの部分は不要です。構成要件の詳細は、「マルチテナント・コンテナ・データベースでのOracle GoldenGateの構成」を参照してください。 `schema`は、スキーマ名またはスキーマのワイルドカード・セットです。 `object`は、表または順序名、またはこれらのオブジェクトのワイルドカード・セットです。ワイルドカードを使用して、または使用せずにオブジェクト名を指定する方法の詳細は、Oracle GoldenGate Oracle GoldenGateの管理for Windows and UNIXを参照してください。パラメータ文はセミコロンで終了します。名前をワイルドカード指定から除外するには、必要に応じて`CATALOGEXCLUDE`、`SCHEMAEXCLUDE`、`TABLEEXCLUDE`および`EXCLUDEWILDCARDOBJECTSONLY`パラメータを使用します。詳細およびデータのフィルタリング、マッピングおよび操作を制御するその他の`TABLE`オプションについては、Oracle GoldenGate Oracle GoldenGateリファレンスfor Windows and UNIXを参照してください。
`MAPINVISIBLECOLUMNS`	Replicatがデフォルトの列マッピングでOracleターゲット表に非表示列を含めるかどうかを制御します。列マッピングで非表示列を構成するには、SQLを使用して列名を明示的に指定します。次に例を示します。 CREATE TABLE tab1 (id NUMBER, data CLOB INVISIBLE); INSERT INTO tab1 VALUES (1, 'a');ERROR: ORA-913 INSERT INTO tab1 (id, data) VALUES (1, 'a'); OK 列の可視性を変更するには、ALTER TABLEを使用します。非表示列は、主キーや一意索引などを含む索引を構成することができます。

構成に推奨されるオプションのExtractパラメータを入力します。このファイルは、GGSCIのEDIT PARAMSコマンドを使用して、処理を開始する前にいつでも編集できます。詳細は、Oracle GoldenGate Oracle GoldenGateリファレンスfor Windows and UNIXを参照してください。
ファイルを保存して閉じます。