ADD EXTTRAIL

使用 ADD EXTTRAIL 可以为本地系统上的联机处理创建线索并：

• 将其与提取组关联。

• 分配最大文件大小。

• 尝试使用 ADD EXTTRAIL 从单个提取进程创建多个线索文件时，如果线索文件数超过特定限制，该操作将失败。具体而言，创建了 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）和记录编号。

  为避免此错误，建议不要从单个提取创建多个线索文件，特别是出于性能原因。首选方法是使用单个提取捕获所有必需的数据，并使用分发服务将其分发到不同的目标。

  另一种替代选项是运行多个提取处理（如果需要减小每个目标的线索文件大小）。

请参阅 Oracle GoldenGate 参数和函数参考中的 EXTTRAIL

语法

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

trail_name

两个字符线索名称。建议这两个字符均为字母，但第一个字符不能为数字。每当创建新文件时，Oracle GoldenGate 都会在此名称后附加一个 9 位数的序号。

线索名称也可使用目录作为前缀。例如，对于名为 north/ea 的线索，线索文件在 $OGG_DATA_HOME/north 子目录中名为 ea000000000、ea000000001。

group_name

线索绑定到的提取组的名称。一个线索只能分配到一个提取。多个提取无法写入同一线索。但是，如果需要，一个提取可以写入多个不同的线索，但通常不需要这样。

MEGABYTES n

序列中每个线索文件的最大大小（以兆字节为单位）。默认值为 500MB，最大值为 2000MB。

SEQNO n

指定线索中的第一个文件以指定的线索序号开始。不包括任何零填充。例如，要在一个名为 tr 的线索中从序号 3 开始，请指定 SEQNO 3。实际文件将名为 /ea000000003。当复制需要重新定位到特定线索序号时，可在故障排除过程中使用此选项。这样，不需要变更复制来读取所需的序号。默认值为 1。

限制

创建与先前提取线索同名的提取线索时，请确保已删除该目录中具有相同 trail_name 的所有线索。

从启用了组复制的 MySQL 数据库进行捕获时，提取只允许有一个线索。

示例

---

以下命令创建名为 ea 的线索：

ADD EXTTRAIL north/ea, EXTRACT exte, MEGABYTES 200

输出显示如下：

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