ADD EXTTRAIL

ADD EXTTRAILでは、ローカル・システム上にオンライン処理用のトレイルを作成し、次のことも行います。

• それをExtractグループに関連付けます。

• 最大ファイル・サイズを割り当てます。

• ADD EXTTRAILを使用して複数の証跡ファイルを作成しようとすると、単一のExtractプロセスから、証跡ファイルの数が特定の制限を超えた場合、操作は失敗します。具体的には、12を超える証跡が作成されると、次のエラーが発生する可能性があります。

  2025-11-05T21:16:04Z  INFO    OGG-08100  Exceeded checkpoint record size (32,768/32,767) in
  
  checkpoint file /path/to/checkpoint/file.cpe.

  このエラーは、チェックポイント・ファイルが32,767レコードのサイズ制限を超えているために発生します。チェックポイント・ファイルには、ファイルのサイズに寄与するCSN (コミット順序番号)、XID (トランザクションID)およびレコード番号が含まれます。

  このエラーを回避するには、特にパフォーマンス上の理由から、単一のExtractから複数の証跡ファイルを作成しないことをお薦めします。推奨される方法は、単一のExtractで必要なすべてのデータを取得し、分散サービスを使用して異なる宛先に分散することです。

  別の方法として、各宛先の証跡ファイル・サイズを小さくする必要がある場合は、複数のExtractプロセスを実行することもできます。

Oracle GoldenGateパラメータおよび機能リファレンスのEXTTRAILを参照してください。

構文

ADD EXTTRAIL trail_name, EXTRACT group_name
[, MEGABYTES n]
[SEQNO n]

trail_name

2文字のトレイル名。両方の文字をアルファベットにすることをお薦めしますが、最初の文字は数字にできません。Oracle GoldenGateは、新しいファイルが作成されると、この名前に9桁の順序番号を追加します。

証跡名には、先頭にディレクトリを付けることもできます。たとえば、north/eaという名前の証跡では、ea000000000、ea000000001という名前の証跡ファイルが$OGG_DATA_HOME/northサブディレクトリにあります。

group_name

トレイルのバインド先となるExtractグループの名前。証跡を割り当てられるのは、1つのExtractのみです。複数のExtractで、同じ証跡に書き込むことはできません。ただし、必要な場合には、1つのExtractで、複数の異なる証跡に書き込むことが可能ですが、通常は必要ありません。

MEGABYTES n

シーケンスの各トレイル・ファイルの最大サイズ(MB)。デフォルトは500MBで、最大値は2000MBです。

SEQNO n

トレイル内の最初のファイルを、指定したトレイル順序番号から開始するように指定します。ゼロの埋込みは使用しないでください。たとえば、trという名前のトレイルを3番から開始するには、SEQNO 3と指定します。実際のファイル名は、/ea000000003になります。このオプションは、Replicatを特定のトレイル順序番号に再配置する必要がある場合のトラブルシューティングで使用できます。これによって、必要な順序番号を読み取るようにReplicatを変更する必要はありません。デフォルト値は1です。

制限事項

以前のExtract証跡と同じ名前でExtract証跡を作成する場合は、同じtrail_nameを持つそのディレクトリ内のすべての証跡が削除されていることを確認します。

MySQLデータベースからのキャプチャがグループ・レプリケーションに対して有効になっている場合は、Extractに対して1つの証跡のみ許可されます。

例

---

次のコマンドは、証跡名eaを作成します:

ADD EXTTRAIL north/ea, EXTRACT exte, MEGABYTES 200

出力は次のようになります:

2019-11-20T23:49:19Z  INFO    OGG-08100  EXTTRAIL added.