EXTTRAIL

有効な対象

Extract

摘要

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

EXTTRAILは、関連するすべてのTABLE文より先に指定する必要があります。複数のEXTTRAIL文を使用してExtractに異なる証跡を定義できます。ただし、1つの証跡のみがサポートされているため、GTIDセット位置を使用する場合のMySQL Extractを除きます。

Oracle GoldenGate 19c以降、プライマリExtractは、FORMAT RELEASEオプションを使用して証跡ファイル形式のバージョンを明示的に指定しないかぎり、アップグレード中に既存の証跡ファイル形式と同じ形式で証跡ファイルを書き込みます。これにより、それ以降の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はマイナー・バージョン番号です。major.minor値には、Oracle GoldenGateの現在または以前のGenerally Available (GA)リリースを反映している必要があります。有効な値は、11.2から現在のOracle GoldenGate X.xバージョン番号(たとえば23.26または19.1)です。

リリース・バージョンは、適切なトレイル・フォーマットの互換性レベルにプログラム的にマップされます。デフォルトは、このトレイルに書込みを行うプロセスの現在のバージョンです。ノート: 12.1より前のRELEASEバージョンでは、3つの部分からなるオブジェクト名はサポートされません。

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

TRAILBYTEORDER {BIGENDIAN

LITTLEENDIAN

NATIVEENDIAN}

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

例

例1

EXTTRAIL ny

例2

Linuxの場合:

EXTTRAIL trails/ny, FORMAT RELEASE 12.3

例3

Windowsの場合:

EXTTRAIL trails\ny, FORMAT RELEASE 12.3

例4

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

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