扩展文件
有效对象
提取和复制
说明
使用 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 及更高版本支持以下设置:
-
对于兼容性设置为 12.1 的 Oracle Database 12。2 非 CDB 或更高版本,支持
FORMAT RELEASE12.2 或更高版本,因为 SCN 值较大。 -
对于兼容性设置为 12.2 的 Oracle Database 12。2 CDB/PDB 或更高版本,只有
FORMAT RELEASE值 12.3 或更高版本受支持。这是由于对 PDB 使用了本地撤消,此功能需要使用 PDB 编号来扩充事务处理ID,以确保事务 ID 的唯一性。
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