输出格式

有效对象

提取

说明

使用 OUTPUTFORMAT 参数以文本、SQL 和 XML 格式输出数据。

默认值

无

语法

OUTPUTFORMAT <format_type>  [, <option>]  [, ...]

输出格式文本

使用 TEXT <format_type> 以外部文本格式而非默认 Oracle GoldenGate 规范格式输出数据。您可以设置与大多数数据库加载实用程序以及需要 ASCII 输入的其他程序兼容的输出格式。file-to-database-utilityinitial load 方法需要此参数。

此类型的语句会影响在参数文件中列出的所有提取文件或线索。参数文件中语句的相对顺序非常重要。如果列在文件或线索规范之后，OUTPUTFORMAT TEXT 将不会生效。

<option> 可以是以下值之一：

INCLUDE (HEARTBEAT)

包括心跳表记录。默认情况下，将忽略心跳表记录。

BCP

将输出格式设置为与 SQL Server 的批量复制程序和其他批量加载实用程序兼容。

指定 BCP <option> 时将忽略以下选项：

• NAMES | NONAMES - 指定是否包括列名。缺省值为 NAMES。

• NULLISSPACE - 将 NULL 列输出为空列。如果没有 NULLISSPACE，则 NULL 列将输出为 NULL。

• PLACEHOLDERS - 输出缺少列的占位符。

• NOHDRFIELDS - 不包括任何元数据，如前后指标和事务处理信息。仅输出列数据。

• DELIMITER 'delimiter' - 指定字段分隔符。要指定表格，请使用 TAB。默认值为逗号 ','。

• OP | _NOOP - 指定是否包括操作类型指示符（I、D、U、V）。缺省值为 OP。

• IND | _NOIND - 指定是否包括图像指示灯（B 或 A）之前和之后。缺省值为 IND。

• _TRANSTMTS | _NOTRANSTMTS - 指定是否包括事务处理信息。默认值为 _TRANSTMTS。

• _WHOLEFILE - 包括全限定对象名称，包括方案名称。

• _FILE - 仅包括对象名称。

SQLLOADER

生成固定长度的文本格式的文件，该文件与 Oracle SQL*Loader 实用程序或 IBM Load 实用程序兼容。

DATE

TIME

TS

指定要输出的记录时间戳精度。默认情况下，此参数不输出记录时间戳。您可以使用以下项之一：

• DATE 可以输出日期（从年到日）。

• TIME 可以输出时间（从年到秒）。

• TS 可以输出事务处理时间戳（从年到微秒）。

SQLLOADER

生成固定长度的 ASCII 格式的文件, 该文件与 Oracle SQL*Loader 实用程序或 IBM Load Utility 程序兼容。

输出格式 SQL

使用 OUTPUTFORMAT SQL 参数以外部 SQL 格式输出数据，而不是默认的 Oracle GoldenGate 规范格式。OUTPUTFORMAT SQL 生成 SQL 语句（INSERT、UPDATE、DELETE），这些语句可以由 Oracle GoldenGate Replicat 之外的实用程序应用于 SQL 表。

INCLUDE (HEARTBEAT)

包括心跳表记录。默认情况下，将忽略心跳表记录。

ENCODING 编码

以指定的编码输出 SQL 格式文件。支持 Oracle GoldenGate 字符集名称。缺省情况下，是当前操作系统字符集。不使用默认字符集对列数据执行字符集转换。

以下选项指定特定的输出格式。选项是独占的，因此不能一起指定。

ORACLE

通过将日期和时间列转换为 SQL*Plus 接受的格式，来设置记录格式，以便与 Oracle Databases 兼容。

SQLPLUS

通过将日期和时间列转换为 SQL*Plus 接受的格式，来设置记录格式，以便与 Oracle Databases 兼容。

SQLLOADER

生成固定长度的文本格式的文件，该文件与 Oracle SQL*Loader 实用程序或 IBM Load 实用程序兼容。

这与 OUTPUTFORMAT TEXT SQLLOADER 完全相同，Oracle 建议您使用它。

_TRANSTMTS

_NOTRANSTMTS

将 SQL 事务处理信息包括为注释。默认值为 _NOTRANSTMTS。

例如：

-B, 2016-07-09:09:9:21.000000,1357991461,627

WHOLEFILE

包括全限定对象名称，包括方案名称。

FILE

仅包括对象名称。

NOPKUPDATES

将 PKUPDATE 和 UNIFIED UPDATE 操作格式为一对 DELETE 和 INSERT 操作。如果未指定选项，PKUPDATE 和 UNIFIED UPDATE 操作将格式化为 UPDATE 操作。如果使用了 SQLLOADER 选项，则此选项将被忽略。

输出格式 XML

使用 OUTPUTFORMAT XML 参数以 XML 格式输出数据，而不是默认的 Oracle GoldenGate 规范格式。OUTPUTFORMAT XML 语句会影响在其后定义的所有提取文件或线索。缺省情况下，XML 是本地操作系统的字符集中的输出。

存储为 CLOB 或 BLOB 的 XML 的输出最大为 4000 字节。要包括存储为 BLOB 或 CLOB 的较大 XML，请使用 ENCODING 选项。

存储为 CLOB 的 XML 始终输出在 CDATA 部分中，而不管其大小如何。这是为了避免将保留字符（如 <、> 和 &）转换为相应的 XML 表示形式的开销。

包括 BLOB 的二进制数据编码为 Base64，它以 ASCII 字符串格式表示二进制数据，并允许输出到 XML。

除非使用 ENCODING 选项在 UTF-8 中输出，否则 XML、数据库对象名称（如表名和列名）以及 CHAR 和 VARCHAR 数据将以操作系统的默认字符集写入。

INCLUDE (HEARTBEAT

LOB

USERTOKEN)

包括心跳表记录。LOB 超过 4000 个字节和 Oracle GoldenGate 用户令牌。

默认情况下，心跳表记录将被忽略，不包括超过 4000 个字节的 LOB 和用户令牌。

BLOB 超过 4000 个字节以 Base64 编码，而 CLOB 超过 4000 个字节以 CDATA 部分格式化。

INLINEPROPERTIES

NOINLINEPROPERTIES

控制属性是包含在 XML 标记中还是单独写入。缺省值为 INLINEPROPERTIES。

TRANS

NOTRANS

控制事务处理边界和提交时间戳是否应包含在 XML 输出中。缺省值为 TRANS。

CLOSETRANS

NOCLOSETRANS

强制关闭已打开的事务处理边界，并在展期时提交时间戳。它在滚动更新后将相同的事务处理边界和提交时间戳标记添加到下一个 XML 文件。

如果未指定 TRANS 选项，则会忽略该选项。

ENCODING xml_encoding

以指定的编码输出 XML 文件。默认值为 UTF-8。支持以下 MIME 编码名称。

UTF-8 ISO-10646 UTF-8，代理对为每字符 4 字节

UTF-16 ISO-10646 UTF-16

windows-1250 Windows 中欧

windows-1251 Windows 西里尔字母

windows-1252 Windows 拉丁语 -1

windows-1253 Windows 希腊语

windows-1254 Windows 土耳其语

windows-1255 Windows 希伯来语

windows-1256 阿拉伯语 Windows

windows-1257 Windows 波罗的海版

windows-1258 Windows 越南版

Windows-874 Windows 泰语

IBM437 DOS 拉丁语 -1

IBM775 波罗的海 DOS 775

IBM850 DOS 多语言

cp851 DOS 希腊语 -1

IBM852 DOS 拉丁语 -2

IBM855 DOS 西里尔字母

IBM857 DOS 土耳其语

IBM00858 DOS 多语言和欧元

IBM860 DOS 葡萄牙语

IBM861 DOS 冰岛语

IBM862 DOS 希伯来语

IBM863 DOS 法语

IBM864 DOS 阿拉伯语

IBM865 DOS 北欧

IBM866 DOS 西里尔字母/GOST 19768-87

IBM868 DOS 乌尔都语

IBM869 DOS 希腊语 -2

ISO-8859-1 ISO-8859-1 拉丁语 -1/西欧语言

SO-8859-2 ISO-8859-2 拉丁语 -2/东欧

ISO-8859-3 ISO-8859-3 拉丁语 -3/南欧

ISO-8859-4 ISO-8859-4 拉丁语 -4/北欧

ISO-8859-5 ISO-8859-5 拉丁语/俄里语

ISO-8859-6 ISO-8859-6 拉丁语/阿拉伯语

ISO-8859-7 ISO-8859-7 拉丁语/希腊语

ISO-8859-8 ISO-8859-8 拉丁语/希伯来文

ISO-8859-9 ISO-8859-9 拉丁语 -5/土耳其语

ISO-8859-10 ISO-8859-10 拉丁语 -6/北欧语

ISO-8859-13 ISO-8859-13 拉丁语 -7/波罗的海边缘

ISO-8859-14 ISO-8859-14 拉丁语 -8/凯尔特语

ISO-8859-15 ISO-8859-15 拉丁语 -9/西欧语言

ISO-8859-16 ISO-8859-16，拉丁语 -10，东南欧

KOI8-R KOI8-R，俄语

KOI8U KOI8-U，乌克兰文

TIS-620 泰国工业标准 620-2533

DEC-MCS DEC 多语言

HP-roman8 HP Latin-1 Roman8

Shift_JIS Shift_JIS、Windows-932

GBK GBK、Windows-936

KSC_5601 KSC-5601、Windows-949

Big5 Big-5 繁体中文，Windows-950

EUC-JP EUC 日语

GB2312 GB-2312-1980

EUC-KR EUC 朝鲜语

GB18030 GB-18030

HZ-GB-2312 HZ GB-2312

Big5-HKSCS Big-5，HongKong 扩展

示例

OUTPUTFORMAT XML NOINLINEPROPERTIES, NOTRANS