EXTTRAIL

有效对象

提取

说明

使用 EXTTRAIL 参数指定使用 ADD EXTTRAIL 命令创建的本地系统上的线索。路径由分发路径或本地系统上的复制读取。

EXTTRAIL 必须位于所有关联的 TABLE 语句之前。多个 EXTTRAIL 语句可用于为提取定义不同的线索，但使用 GTID 集定位时 MySQL 提取除外，因为仅支持一个线索。

从 Oracle GoldenGate 19c 开始，主提取在升级期间以与现有线索文件格式相同的格式写入线索文件，除非您使用 FORMAT RELEASE 选项显式指定线索文件格式版本。这可防止后续复制在未升级时异常终止。

可以使用 ENCRYPTTRAIL 参数加密此线索中的数据。有关更多信息，请参见 "ENCRYPTTRAIL \| NOENCRYPTTRAIL "。

注：将 ENCRYPTRAIL 参数与 EXTTRAIL 参数一起使用时，请确保在 EXTTRAIL 之前提及 ENCRYPTRAIL 参数，否则不会对线索进行加密。

注意：发送至 NSK 的分发路径要使用的本地线索必须使用 TRAILBYTEORDER BIGENDIAN。无法在数据泵中进行变更。

默认值

无

语法

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

<trail_name>

线索的相对路径或全限定路径名称。线索名称只能包含两个字符。

注：在微服务体系结构中，线索文件名的两字符前缀只能以字母开头。

每当创建新文件时，Oracle GoldenGate 都会在此名称后附加一个 9 位数的序号。例如，名称 /tr 的线索将具有名为 /tr000000001、/tr000000002 的文件。

FORMAT RELEASE <major.minor>

对提取有效。指定提取发送到线索、文件或其他进程（如果是远程任务）的数据的元数据格式。元数据告知读取进程，数据记录版本是否是它支持的版本。元数据格式取决于 Oracle GoldenGate 进程的版本。较早的 Oracle GoldenGate 版本包含的元数据与较新的版本不同。

FORMAT RELEASE 指定 Oracle GoldenGate 发行版本。major 是主版本号，minor 是次版本号。major.minor 值必须反映 Oracle GoldenGate 当前或较早的普遍可用 (Generally Availability，GA) 发行版。有效值为 11.2 到当前 Oracle GoldenGate X.x 版本号，例如 23.26 或 19.1。

发行版本以编程方式映射到相应的线索格式兼容性级别。默认值为向此线索写入的进程的当前版本。注意：早于 12.1 的 RELEASE 版本不支持由三个部分组成的对象名称。

注：如果在单个提取中使用多个线索，则仅相同的 RELEASE 版本可以共存。

TRAILBYTEORDER {BIGENDIAN

LITTLEENDIAN

NATIVEENDIAN}

设置线索文件的字节格式。仅对 FORMAT RELEASE 版本至少为 12.1 的线索有效。有效值为 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

捕获的相同表集中的两种线索格式：

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