丢弃文件 | NODISCARDFILE

有效对象

提取和复制

说明

使用 DISCARDFILE 参数执行以下操作：

• 定制放弃文件的名称、位置、大小和写入模式。缺省情况下，只要进程使用 START 命令启动，就会生成丢弃文件。要保留默认属性，不需要 DISCARDFILE 参数。

• 指定使用放弃文件来处理进程从操作系统的命令行启动且缺省情况下不会创建放弃文件的处理方法。

使用 NODISCARDFILE 参数可禁止使用放弃文件。如果 NODISCARDFILE 与 DISCARDFILE 一起使用，则进程将异常终止。

使用 DISCARDFILE 时，请使用 PURGE 或 APPEND 选项。否则，在启动每个进程运行之前，必须指定不同的放弃文件名，因为如果没有这些指令之一，Oracle GoldenGate 将不会写入现有放弃文件，并且将终止。

有关如何控制丢弃文件的滚动到新文件的频率，请参见 DISCARDROLLOVER 。

有关放弃文件的更多信息，请参阅Oracle GoldenGate 错误处理概览。

默认值

如果进程是使用 START 命令启动的，则会按如下方式生成放弃文件：

• 文件以创建文件的进程命名，扩展名为 .dsc。如果进程是协调复制进程，则它会为每个线程生成一个文件。每个文件名都附加有对应线程的线程 ID。

• 该文件在 Oracle GoldenGate 安装目录的 dirrpt 子目录中创建。

• 最大文件大小为 50 MB。

• 在启动时，如果存在放弃文件，则会在写入新数据之前将其清除。

• 最大文件名是 250 个字符（包括目录）。

从操作系统的命令行启动进程时，默认情况下不应生成放弃文件。

语法

DISCARDFILE { [<file_name>]
[, APPEND | PURGE]
[, MAXBYTES <n> | MEGABYTES <n>] } |
NODISCARDFILE

DISCARDFILE

指明正在更改放弃文件的名称或其他属性。

<file_name>

放弃文件的相对或全限定名称，包括实际文件名。对于协调复制，请指定最多五个字符的文件名，因为每个文件名都附加有写入该文件的线程的线程 ID。要将文件存储在 Oracle GoldenGate 目录中，相对路径名就足够了，因为 Oracle GoldenGate 使用 Oracle GoldenGate 安装目录对名称进行限定。

APPEND

将新内容添加到现有内容（如果该文件已存在）。如果 APPEND 和 PURGE 都未使用，则必须在启动每个进程运行之前指定不同的放弃文件名。

PURGE

在写入新内容之前清除文件。如果 PURGE 和 APPEND 都未使用，则必须在启动每个进程运行之前指定不同的放弃文件名。

MAXBYTES <n>

以字节为单位设置文件的最大大小。有效范围为从 1 到 4096967295。默认值为 3000000。如果超出指定的大小，则进程将异常终止。

MEGABYTES <n>

设置文件的最大大小（以 MB 为单位）。有效范围为从 1 到 4096。默认值为 3。如果超出指定的大小，则进程将异常终止。

NODISCARDFILE

阻止进程创建放弃文件。

示例

示例 1

此示例指定非默认文件名和扩展名、非默认写入模式以及非默认最大文件大小。此示例说明如何更改联机进程的丢弃文件的缺省属性，或者为从操作系统的命令行开始且默认情况下没有丢弃文件的进程指定丢弃文件的使用。

DISCARDFILE .dirrpt/discard.txt, APPEND, MEGABYTES 20

示例 2

此示例仅更改联机进程的默认放弃文件的写入模式。

DISCARDFILE .dirrpt/finance.dsc, APPEND

示例 3

此示例禁止对联机进程使用放弃文件。

NODISCARDFILE