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

兩個字元歷程檔名稱。建議兩個字元皆為字母，但第一個字元不得為數字。每當有新檔案建立時，Oracle GoldenGate 都會在此名稱附加一組九位數的序號。

歷程檔名稱前面也可以加上一個目錄。例如，名為 north/ea 的歷程檔在 $OGG_DATA_HOME/north 子目錄中會有名為 ea000000000、ea000000001 的歷程檔。

group_name

與歷程檔連結的 Extract 群組名稱。一個歷程檔只能指定給一個 Extract。您無法將多個 Extracts 寫入同一個歷程檔。然而，如有需要，您可以把一個 Extract 寫入多個不同的歷程檔，但這通常不是必要的。

MEGABYTES n

序列中每個歷程檔的大小上限 (MB)。預設值是 500MB，最大值是 2000MB。

SEQNO n

指定歷程檔中的第一個檔案將以指定的歷程檔序號為開頭。請勿填補任何零。例如，若要在名為 tr 的歷程檔序列 3 開始，請指定 SEQNO 3。實際的檔案會命名為 /ea000000003。當 Replicat 需要重新定位至特定追蹤序號時，便可在疑難排解時使用此選項。這樣就不需要改變 Replicat 以讀取所需的序號。預設值為 1。

限制

建立與先前 Extract 歷程檔相同名稱的 Extract 歷程檔時，請確定已刪除該目錄中具有相同 trail_name 的所有歷程檔。

從啟用群組複製的 MySQL 資料庫執行擷取時，一個 Extract 僅允許使用一個歷程檔。

範例

---

下列命令會建立歷程檔名稱 ea：

ADD EXTTRAIL north/ea, EXTRACT exte, MEGABYTES 200

輸出會顯示下列內容：

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