扩展文件

有效对象

提取和复制

说明

使用 EXTFILE 参数指定本地系统上的提取文件,该文件将由初始加载提取创建,并在使用 SPECIALRUN 时由初始加载复制读取。

将此参数用于初始加载配置。对于联机更改同步,请使用 EXTTRAIL 参数。

EXTFILE 必须位于所有关联的 TABLE 或 MAP 语句之前。可以使用多个 EXTFILE 语句定义不同的文件。

Replicat 仅支持 file_name 值,不支持任何选项。

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

默认值

无

语法

EXTFILE <file_name>
[ APPEND]
[, PURGE]
[, FORMAT RELEASE <major>.<minor>]
[, MEGABYTES <megabytes>]
[, OBJECTDEFS]
[, TRAILBYTEORDER {BIGENDIAN | LITTLEENDIAN | NATIVEENDIAN}]

<file_name>

线索的相对名称或全限定名称。仅为线索名称使用两个字符。如果使用两个以上的字符,它将创建具有该名称但不包含任何序列号的文件。随着线索文件的过期,将向此名称添加一个六字符的序列号,例如 /ogg/dirdat/ef000001。如果使用 FORMAT RELEASE 12.2 或更早版本,则创建的线索文件是一个不递增的静态文件,并且命名约定不限于两个字符。

APPEND

将当前数据添加到文件中的现有数据。如果使用 APPEND,请勿使用 PURGE。

PURGE

在创建新文件之前删除现有文件。如果使用 PURGE,请勿使用 APPEND。

FORMAT RELEASE <major.minor>

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

FORMAT RELEASE 指定 Oracle GoldenGate 发行版本。major 是主版本号,minor 是次版本号。X.x 必须反映 Oracle GoldenGate 当前或较早的普遍可用 (Generally Available, GA) 发行版。有效值是 12.2 到当前 Oracle GoldenGate X.x 版本号,例如 19.1。发行版本以编程方式映射到相应的线索格式兼容性级别。默认值为向此线索写入的进程的当前版本。注意:早于 12.2 的 RELEASE 版本不支持由三个部分组成的对象名称。

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

Oracle Database 12.2 及更高版本支持以下设置:

MEGABYTES <megabytes>

线索中文件的最大大小(以兆字节为单位)。默认值为 2000。

OBJECTDEFS

使用 OBJECTDEFS 选项可将对象定义包括在线索中。仅当以 Oracle GoldenGate 规范格式设置输出线索并且线索格式发行版大于 12.2 时,此选项才适用。否则,将忽略此选项,因为不会向线索添加任何元数据记录。

TRAILBYTEORDER {BIGENDIAN LITTLEENDIAN NATIVEENDIAN}

设置线索文件的字节格式。仅对 FORMAT RELEASE 版本至少为 12.2 的线索文件有效。有效值为 BIGENDIAN(大尾数)、LITTLEENDIAN(小尾数)和 NATIVEENDIAN。默认值为 NATIVEENDIAN。有关其他使用说明,请参见 GLOBALS 版本的 TRAILBYTEORDER 。

示例

示例 1

EXTFILE dirdat/ef

示例 2

EXTFILE dirdat/ef, MEGABYTES 200

示例 3

EXTFILE /ggs/dirdat/extdat, FORMAT RELEASE 18.1