EXTTRAIL

適用対象

Extract

説明

EXTTRAILパラメータでは、ADD EXTTRAILコマンドで作成されたローカル・システム上のトレイルを指定します。トレイルは、分散パスまたはローカル・システム上のReplicatによって読み取られます。

EXTTRAILは、関連するすべてのTABLE文よりも先に指定する必要があります。異なるトレイルを定義するために、複数のEXTTRAIL文を使用できます。

Oracle GoldenGate 19c以降では、FORMAT RELEASEオプションを使用してトレイル・ファイル形式のバージョンを明示的に指定しないかぎり、プライマリExtractはアップグレード時に既存のトレイル・ファイル形式と同じ形式でトレイル・ファイルを書き込みます。これにより、それ以降のReplicatがアップグレードされていない場合に異常終了することを防止します。

ENCRYPTTRAILパラメータを使用して、このトレイル内のデータを暗号化できます。詳細は、ENCRYPTTRAIL | NOENCRYPTTRAILを参照してください。

ノート:

EXTTRAILパラメータでENCRYPTRAILパラメータを使用する場合は、EXTTRAILの前にENCRYPTRAILパラメータが指定されていることを確認してください。指定されていない場合、トレイルは暗号化されません。

ノート:

NSKに送信する分散パスによって使用されるローカル・トレイルは、TRAILBYTEORDER BIGENDIANを使用する必要があります。これはデータ・ポンプでは変更できません。

デフォルト

なし

構文

EXTTRAIL file_name
[, FORMAT RELEASE major.minor]
[, TRAILBYTEORDER {BIGENDIAN | LITTLEENDIAN | NATIVEENDIAN}]

trail_name

トレイルの相対パス名または完全修飾パス名。トレイル名に含められる文字数は2文字のみです。

ノート:

Microservices Architectureでは、証跡ファイル名の2文字の接頭辞はアルファベットで始める必要があります。

Oracle GoldenGateは、新しいファイルが作成されるたびに、この名前に9桁の順序番号を追加します。たとえば、/trという名前の証跡には、/tr000000001、/tr000000002という名前のファイルがあります。

FORMAT RELEASE major.minor

Extractに対しては無効です。Extractから、トレイル、ファイル、または(リモート・タスクの場合)別のプロセスに送信されるデータのメタデータ・フォーマットを指定します。リーダー・プロセスは、メタデータに基づいて、データ・レコードが自身がサポートしているバージョンかどうかを把握します。メタデータのフォーマットは、Oracle GoldenGateプロセスのリリースによって異なります。古いOracle GoldenGateリリースには、新しいリリースとは異なるメタデータが含まれます。

FORMAT RELEASEでは、Oracle GoldenGateのリリース・バージョンを指定します。majorはメジャー・バージョン番号、minorはマイナー・バージョン番号です。X.xには、Oracle GoldenGateの現在または以前のGenerally Available (GA)リリースを指定する必要があります。有効な値は、12.2から現行のOracle GoldenGate X.xバージョン番号19.1までです。

リリース・バージョンは、プログラムによって適切なトレイル・フォーマット互換性レベルにマッピングされます。デフォルトは、このトレイルに書き込むプロセスの現在のバージョンです。

ノート:

サポートされている最低バージョンは12.2です。

ノート:

12.1より前のRELEASEのリリースでは、3つの部分からなるオブジェクト名はサポートされません。

ノート:

単一のExtractで複数の証跡を使用する場合は、同じRELEASEバージョンのみが共存できます。

TRAILBYTEORDER {BIGENDIAN | LITTLEENDIAN | NATIVEENDIAN}

トレイル・ファイルのバイト・フォーマットを設定します。12.1以上のバージョンのFORMAT RELEASEが指定されているトレイルにのみ有効です。有効な値は、BIGENDIAN (ビッグ・エンディアン)、LITTLEENDIAN (リトル・エンディアン)およびNATIVEENDIANです。デフォルトはNATIVEENDIANです。使用方法の詳細は、GLOBALSバージョンの「TRAILBYTEORDER」を参照してください。

例

例1

EXTTRAIL dirdat/ny

例2

EXTTRAIL /ggs/dirdat/ex, FORMAT RELEASE 18.1

例3

キャプチャされるのと同じ表のセット内の2つのトレイル・フォーマット:

EXTTRAIL ./dirdat/ea
TABLE hr.tab1 
TABLE hr.tab2 
EXTTRAIL ./dirdat/eb
TABLE scott.tab3 
TABLE scott.tab4