Extractの構成

6 Extractの構成

この章では、トランザクション・データをキャプチャするようにOracle GoldenGateキャプチャ・プロセスを構成する手順について説明します。

Extractがリモート・システムから実行されている場合、Oracle GoldenGateでは、クロス・エンディアンの相互運用性が自動的に有効になります。これは、Extractが実行されているサーバーのエンディアン値とOracleデータベースが実行されているサーバーのエンディアン値が異なる場合に、クロス・エンディアンのサポートが自動的に有効になることを意味します。クロス・エンディアンのExtractが機能するには、ソース・データベースの互換性パラメータが11.2.0.4以上になっている必要があります。

内容は次のとおりです。

Extractの構成の前提条件
Extractを構成する前に、この項に示したガイドラインに従う必要があります。
これらの手順でできること
次の手順では、プライマリExtract (データ・ソースからトランザクション・データをキャプチャ)、およびデータ・ポンプExtract (trailにローカルに格納されているキャプチャ済データをソース・システムからターゲット・システムに伝播)のExtractパラメータ(構成)ファイルの構成方法について説明します。
プライマリExtractの構成
プライマリExtractがログマイニング・サーバーからログ変更レコードをキャプチャするマイニング・データベースは、ローカルであるか、ソース・データベースからのダウンストリームであるかのどちらかです。
自動Extractモードの設定
自動Extractモードでは、論理レプリケーションが有効になっているすべての表に対する変更がキャプチャされます。
データ・ポンプExtractの構成
一般に、データ・ポンプはデータのフィルタリング、マッピングおよび変換を実行できますが、データを操作せずにそのままの状態で単純に転送するパススルー・モードでデータ・ポンプを構成することも可能です。
次のステップ
パラメータ・ファイルは、関連するOracle GoldenGateプロセスによって読み取られるプレーン・テキスト・ファイルです。Oracle GoldenGateでは、GLOBALSファイルとランタイム・パラメータ・ファイルという2種類のパラメータ・ファイルが使用されます。

6.1 Extractの構成の前提条件

Extractを構成する前に、この項に示したガイドラインに従う必要があります。

統合モードでExtractを構成する手順は次のとおりです。

Oracle GoldenGateのためのデータベースの準備
Oracle GoldenGate資格証明の確立
Extractでの各種Replicatモードの選択。
Microservices Architectureの場合、Extractプロセスのデプロイメントが稼働中であることが必要です。デプロイメントの開始の詳細は、「デプロイメントとサービスを開始または停止する方法」を参照してください。

Classic Architectureの場合、Extractの追加前または起動前にManagerを起動しておく必要があります。
また、『Oracle GoldenGateの管理』のガイドラインも確認してください。

親トピック: Extractの構成

6.2 この手順でできること

次の手順では、プライマリExtract(データ・ソースからトランザクション・データをキャプチャ)、およびデータ・ポンプExtract (trailにローカルに格納されているキャプチャ済データをソース・システムからターゲット・システムに伝播)のExtractパラメータ(構成)ファイルの構成方法について説明します。

ビジネス要件によってはより複雑なトポロジが必要ですが、この手順がその他の構成ステップの基礎となります。

ステップを実行することで、次のことが可能です。

基本的な構成ファイルが作成されます。
後で環境に適用する機能や要件について決定を下してパラメータを追加し、それらを拡張します。
コピーを使用して、一から作成するよりも短時間で追加パラメータ・ファイルを作成します。

親トピック: Extractの構成

6.3 プライマリExtractの構成

プライマリExtractがログマイニング・サーバーからログ変更のレコードをキャプチャするマイニング・データベースは、ローカルまたはソース・データベースからダウンストリームのいずれかが可能です。

次のステップでは、どちらかの場所からトランザクション・データをキャプチャするようにプライマリExtractを構成します。ダウンストリーム・マイニング・データベースからのキャプチャの詳細は、「ダウンストリーム・マイニング・データベースの構成」および「ダウンストリーム・マイニング構成の例」を参照してください。

ノート:

マルチテナント・コンテナ・データベース内の単一データベースまたは複数のプラガブル・データベースからキャプチャするには、一般的に1つのExtractグループで十分です。「マルチテナント・コンテナ・データベースでのOracle GoldenGateの構成」を参照してください。Autonomous Data Warehouse (ADW)またはクラウド環境で作業する場合は、PDB単位のキャプチャ・モードを選択することもできます。「Autonomous DatabaseからキャプチャするExtractの構成」を参照してください。

ソース・システムのGGSCI、Admin ClientまたはREST APIクライアントで、Extractパラメータ・ファイルを作成します。
```
EDIT PARAMS name
```
説明: nameは、プライマリExtractの名前です。
ノート:
Oracle GoldenGateマイクロサービスを使用してこのタスクを実行する方法について学習するには、Extractの追加方法に関する項を参照してください。

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

非マルチテナント・データベースをマイニングするExtractの基本的なパラメータ

EXTRACT financep
USERIDALIAS c##_alias
DDL INCLUDE MAPPED
EXTTRAIL /ggs/dirdat/lt
SEQUENCE hr.employees_seq;
TABLE hr.*;

マルチテナント・データベースからキャプチャするExtractの基本的なパラメータ

EXTRACT financep
USERIDALIAS c##_alias
DDL INCLUDE MAPPED 
EXTTRAIL /ggs/dirdat/lt
TABLE test.ogg.tab1;
SEQUENCE hr.employees_seq;
TABLE hr.*;
TABLE sales.*;
TABLE acct.*;

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

EXTRACT financep
USERIDALIAS c##_alias 
TRANLOGOPTIONS MININGUSERALIAS c##_alias 
TRANLOGOPTIONS INTEGRATEDPARAMS (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.*;

パラメータ	説明
EXTRACT `group`	`group`は、Extractグループの名前です。詳細は、『Oracle GoldenGateリファレンス』を参照してください。
USERIDALIAS `alias`	Extractに割り当てられるユーザーのデータベース・ログイン資格証明の別名を指定します。この資格証明は、Oracle GoldenGate資格証明ストアに存在する必要があります。
`LOGALLSUPCOLS`	競合検出および解決に必要な列、統合Replicatのサポートに必要なスケジューリング列を含む、証跡に補足的にログに記録されるすべての列を書き込みます。(スケジューリング列は、主キー、一意索引および外部キー列です。)これらの列をGGSCIコマンドでログに記録するようにデータベースを構成します。「Oracle GoldenGate資格証明の確立」を参照してください。
`UPDATERECORDFORMAT COMPACT`	`UPDATE`操作の変更前および変更後のイメージを証跡の単一レコードに結合します。このパラメータは、Oracle Databaseバージョン12c以上で有効で、統合モードのReplicatをサポートします。必須パラメータではありませんが、`UPDATERECORDFORMAT COMPACT`がベスト・プラクティスで、Replicatパフォーマンスを大幅に改善します。
`TRANLOGOPTIONS MININGUSERALIAS` `alias`	ダウンストリーム・マイニング・データベース(使用する場合)で、ログマイニング・サーバーの接続情報を指定します。 `MININGUSERALIAS`では、ダウンストリーム・マイニング・データベースのExtractユーザーの別名を指定します。これは、「ダウンストリーム・マイニング・データベースの構成」で作成したユーザーです。このユーザーの資格証明は、Oracle GoldenGate資格証明ストアに格納する必要があります。データベース・ログマイニング・サーバーがソース・データベースと異なるデータベースにある場合にのみ`MININGUSERALIAS`を使用し、そうでない場合は`USERIDALIAS`を使用します。`MININGUSERALIAS`を使用する場合、両方のデータベースで資格証明が必要なため、`USERIDALIAS`とともに使用します。
TRANLOGOPTIONS [INTEGRATEDPARAMS (`parameter`[, ...])]	(オプション)データベース・ログマイニング・サーバーを含むOracle Databaseにパラメータを渡します。ログマイニング・サーバー・パラメータをデフォルト設定から変更する場合にのみ使用します。「Extractのその他のパラメータ・オプション」を参照してください。
`TRANLOGOPTIONS CHECKPOINTRETENTIONTIME` `days`	(オプション)チェックポイントが自動的にパージされるまでExtractが保持する日数を制御します。部分的な日数は、10進値を使用して指定されます。たとえば、8.25は8日と6時間を指定します。詳細は、『Oracle GoldenGateリファレンス』を参照してください。
`DDL` `include_clause`	DDL操作をレプリケートする場合に必要です。詳細は、「DDLサポートの構成」を参照してください。
ENCRYPTTRAIL `algorithm`	ローカル証跡を暗号化します。
EXTTRAIL `pathname`	プライマリExtractによってキャプチャされたデータが書き込まれるローカル証跡のパス名を指定します。
`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`パラメータで指定されている場合、名前のコンテナの部分は不要です。 `schema`は、スキーマ名またはスキーマのワイルドカード・セットです。 `object`は、表または順序名、またはこれらのオブジェクトのワイルドカード・セットです。パラメータ文はセミコロンで終了します。名前をワイルドカード指定から除外するには、必要に応じて`CATALOGEXCLUDE`、`SCHEMAEXCLUDE`、`TABLEEXCLUDE`および`EXCLUDEWILDCARDOBJECTSONLY`パラメータを使用します。
`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コマンドを使用して、処理を開始する前の任意の時点で編集できます。
ファイルを保存して閉じます。

親トピック: Extractの構成

6.4 自動Extractモードの設定

自動Extractモードでは、論理レプリケーションが有効になっているすべての表に対する変更がキャプチャされます。

自動Extractを設定するには、Oracle Database 21c以降が必要です。次の場合に、表の論理レプリケーションまたは自動キャプチャが可能になります。

テーブルまたはスキーマ・レベルで十分なIDまたはスケジューリング・キーのサプリメンタル・ログ・データがあること。
主キー(PK)、一意識別子(UI)、外部キー(FK)サプリメンタル・ログ・データおよびALLKEYSサプリメンタル・ログ・データがあること。主キーがない場合、スキーマ全体のサプリメンタル・ロギング・レベルですべての一意キーがログに記録されるため、PK、UIおよびFKに加えてALLKEYSが必要です。

自動Extractモードを使用する利点

キャプチャされる表セットの構成が容易
キャプチャされる表セットの変更時に、TABLE/TABLEEXCLUDEパラメータを更新することや、Extractを停止して再起動することが不要になります。

自動キャプチャの有効化

構文と使用方法は、TRANLOGOPTIONS INTEGRATEDPARAMSを参照してください。

次のDDLを使用して、表レベルで自動キャプチャを有効にします。

CREATE/ATLER TABLE table_name ENABLE LOGICAL REPLICATION ALLKEYS

または

CREATE/ALTER TABLE table_name ENABLE LOGICAL REPLICATION ALLOWNONVALIDATEDKEYS

親トピック: Extractの構成

6.5 データ・ポンプExtractの構成

データ・ポンプはデータのフィルタリング、マッピングおよび変換を実行できますが、データを操作せずにそのままの状態で単純に転送するパススルー・モードでデータ・ポンプを構成することも可能です。

次のステップでは、ローカル証跡を読み取り、データをネットワーク経由でリモート証跡に送信するデータ・ポンプを構成します。データ・ポンプはオプションですが、使用することをお薦めします。

ノート:

マイクロサービスを使用してこのタスクを実行する場合は、『Oracle GoldenGate Microservices Architectureの使用』のパスの追加方法に関する項を参照してください。

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

次に示す順序でデータ・ポンプ・パラメータを入力します。パラメータ文ごとに新しい行を開始します。入力変数は異なるものになります。

非CDBデータベースからの2つの部分からなるオブジェクト名を使用したデータ・ポンプのExtractグループの基本的なパラメータ

EXTRACT extpump
USERIDALIAS tiger1
RMTHOST fin1, MGRPORT 7809 ENCRYPT AES192, KEYNAME securekey2
RMTTRAIL /ggs/dirdat/rt
SEQUENCE hr.employees_seq;
TABLE hr.*;

マルチテナント・データベース・データを含む証跡からの3つの部分からなるオブジェクト名を使用したデータ・ポンプのExtractグループの基本的なパラメータ(プラガブル・データベースを含む):

EXTRACT extpump
USERIDALIAS tiger1
RMTHOST fin1, MGRPORT 7809 ENCRYPT AES192, KEYNAME securekey2
RMTTRAIL /ggs/dirdat/rt
TABLE test.ogg.tab1;
SOURCECATALOG pdb1
SEQUENCE hr.employees_seq;
TABLE hr.*;
SOURCECATALOG pdb2
TABLE sales.*;
TABLE acct.*;

パラメータ	説明
EXTRACT `group`	`group`は、データ・ポンプExtractの名前です。詳細は、『Oracle GoldenGateリファレンス』を参照してください。
USERIDALIAS `alias`	Extractに割り当てられるユーザーのデータベース・ログイン資格証明の別名を指定します。この資格証明は、Oracle GoldenGate資格証明ストアに存在する必要があります。
RMTHOST `hostname`, MGRPORT `portnumber`, [, ENCRYPT `algorithm` KEYNAME `keyname`]	`RMTHOST`では、ターゲット・システムの名前またはIPアドレスを指定します。 `MGRPORT`では、ターゲットでManagerが実行されるポートの番号を指定します。 `ENCRYPT`では、TCP/IPでのデータの暗号化(オプション)を指定します。
RMTTRAIL `pathname`	リモート証跡のパス名を指定します。
`SOURCECATALOG` `container`	このパラメータは、ソース・データベースがマルチテナント・コンテナ・データベースの場合に使用します。2つの部分からなる名前を含む後続のすべての`TABLE`および`SEQUENCE`パラメータで、デフォルトのコンテナとして使用されるプラガブル・データベースの名前を指定します。このパラメータでは、3つの部分からなる名前(`container.schema.object`)ではなく、2つの部分からなるオブジェクト名(`schema.object`)を使用できます。別の`SOURCECATALOG`パラメータが発生するか、3つの部分からなる完全な`TABLE`または`SEQUENCE`指定が発生するまで実質的に保持されます。このパラメータは、ソース・データベースがマルチテナント・コンテナ・データベースの場合に使用します。
{TABLE \| SEQUENCE} `[container.]schema.object`;	表または順序、またはワイルドカードで指定された複数のオブジェクトを指定します。ほとんどの場合、このリストはプライマリExtractパラメータ・ファイルのリストと同じです。 `TABLE`は、表または表のワイルドカード・セットを指定します。 `SEQUENCE`は、順序または順序のワイルドカード・セットを指定します。 `container`は、表または順序を格納するルート・コンテナまたはプラガブル・データベースの名前です(このソース・データベースがマルチテナント・コンテナ・データベースの場合)。この表の`SOURCECATALOG`の説明を参照してください。 `schema`は、スキーマ名またはスキーマのワイルドカード・セットです。 `object`は、表または順序の名前、またはこれらのオブジェクトのワイルドカード・セットです。このパラメータ文はセミコロンで終了します。表または順序をワイルドカード指定から除外するには、`TABLE`文の後に`TABLEEXCLUDE`または`SEQUENCEEXCLUDE`パラメータを使用します。