ADD REPLICAT

使用 ADD REPLICAT 可以创建复制组。此命令会创建一个用于创建检查点的联机进程组，以便在运行期间保持处理连续性。对于所有关键字和输入（包括您为 DESC 选项输入的任何文本），该命令大小不能超过 500 字节。

在 Oracle GoldenGate 中，Oracle GoldenGate 服务管理器的每个实例最多支持 5,000 个并发提取组和复制组。在支持的级别上，可以使用命令（例如 INFO 和 STATUS 命令）完全控制和查看所有组。

Oracle GoldenGate 建议将提取组和复制组的数量（组合）保持在默认的 300 或以下级别，以有效地管理环境。

(Oracle) 除非使用 INTEGRATED 选项，否则此命令将以非集成模式创建复制组。

语法

ADD REPLICAT group_name
[, PARALLEL [, INTEGRATED] | INTEGRATED | COORDINATED [MAXTHREADS number]]
{, EXTTRAIL trail_name}
[, BEGIN {NOW | yyyy-mm-dd[ hh:mi:[ss[.cccccc]]]}]
[, EXTRBA rba]
{, CHECKPOINTTABLE owner.table}
[, DESC 'description']
[, ENCRYPTIONPROFILE encryption-profile-name ]
                [ CRITICAL        [ YES | NO ]  ]
                [ PROFILE          profile-name
[ AUTOSTART
                [ YES | NO ]
                [ DELAY delay-number ] ]
                [ AUTORESTART [ YES | NO ]
                [ RETRIES      retries-number ]
                [ WAITSECONDS  wait-number    ]
                [ RESETSECONDS reset-number   ]
                [ DISABLEONFAILURE [ YES | NO ]     ] ] ]

group_name

复制组的名称。如果不指定任何选项，则将创建经典复制。协调和并行复制组的名称最多可以包含五个字符。常规复制组的名称最多可以包含八个字符。

INTEGRATED

(Oracle) 以集成模式创建复制。不使用此选项，ADD REPLICAT 将以非集成（经典）模式创建复制。此选项也适用于并行复制。在此模式下，复制进程利用 Oracle AI Database 中提供的应用处理功能。在此模式下，复制运行方式如下：

• 读取 Oracle GoldenGate 线索。

• 执行数据筛选、映射和转换。

• 构造表示源数据库 DML 或 DDL 事务处理（按提交顺序）的逻辑更改记录 (logical change record, LCR)。

• 通过轻量级流接口连接到目标数据库（称为数据库入站服务器）中的后台进程。

• 将 LCR 传输到入站服务器，以将数据应用于目标数据库。

• 如果使用以下任何功能，则必须使用集成模式（常规集成或并行集成）的复制：

  • 自动冲突检测和解决

  • 过程复制

  • DML 或 DDL 处理程序

INTEGRATED 必须用于从本地 EXTTRAIL 指定的线索读取的联机更改同步复制。

集成复制和集成模式下的并行复制都维护检查点表（如果存在）。另请参见 ADD CHECKPOINTTABLE 。

集成的复制或集成模式下的并行复制不维护 TRACETABLE。

在集成模式下，复制不支持以下参数：

• BULKLOAD（不要使用集成复制作为初始加载复制。）

• GENLOADFILES

• SHOWSYNTAX

• MAXTRANSOPS（已忽略）

PARALLEL

对所有支持的数据库有效。

以并行模式添加复制。在此模式下，复制将并行应用事务处理以提高性能。它考虑事务处理之间的相关项。PARALLEL INTEGRATED 复制仅对 Oracle 有效。它在集成模式下添加并行复制，如 Integrated Replicat 利用 Oracle AI Database 中提供的应用处理功能。

注：为 Sybase 配置并行复制时，请确保升级到版本 16.0 SP3 PL15 及更高版本，以防止管理服务间歇性地断开连接。

COORDINATED [MAXTHREADS number]

以协调模式创建复制。协调复制为多线程，以支持并行处理。此选项添加协调器（由组名标识）以及默认或使用 MAXTHREADS 指定的最大处理线程数。相关项由协调器计算和协调，SQL 处理由线程执行。

要创建 COORDINATED 复制，需要检查点表。

COORDINATED 必须用于从本地 EXTTRAIL 指定的线索读取的联机更改同步复制。注：协调复制的组名只能包含五个字符。

MAXTHREADS number

指定此复制组可以衍生的最大处理线程数。这些线程都在启动时创建，但具体取决于参数文件中的 MAP 语句中指定的内容，这些线程中的一部分或全部线程将在任何给定时间处理工作量。作为一般规则，指定的线程数是对工作量分区时在 MAP 语句中指定的线程数的两倍。这允许您在工作量增加时添加线程，而不必删除和重新创建复制组；有关如何联机程之间对工作量分区的更多信息，请参见 TABLE \| MAP 。

如果省略 MAXTHREADS，则默认线程数为 25。线程的最大数量为 500。

MAXTHREADS 与 MAXGROUPS 参数相关。MAXGROUPS 控制每个 Oracle GoldenGate 实例允许的最大进程组（提取和复制）数。在 MAXGROUPS 的上下文中，每个复制线程被视为一个复制组。因此，Oracle GoldenGate 实例中的提取组和复制组的数量加上 MAXTHREADS 值不能超过 MAXGROUPS 的值，请参见 MAXGROUPS

EXTTRAIL trail_name

指定通过 ADD EXTTRAIL 命令创建的线索的相对或全限定名称。

BEGIN {NOW

yyyy-mm-ddT[ hh:mm[:ss[.cccccc]]]Z}

定义线索中的初始检查点。

NOW

从创建组时开始复制更改。

yyyy-mm-ddT[ hh:mm[:ss[.cccccc]]]Z

从特定时间开始提取更改。

EXTRBA extrba

对 Db2 z/OS 有效。

指定由 EXTSEQNO 指定的线索文件中的相对字节地址。使用此选项之前，请与 Oracle 技术支持联系。

CHECKPOINTTABLE {owner.table

NODBCHECKPOINT}

对 Oracle GoldenGate 应用程序适配器或 Oracle GoldenGate Big Data 无效。

NODBCHECKPOINT 对于目标 Oracle AI Database 无效。Oracle 强烈建议使用检查点表。集成模式和非集成模式下的并行和协调复制需要检查点表。

指定此复制组会将检查点写入数据库中的指定表。包含所有者和表名，就像在 ggadmin.ggs_checkpoint 中一样。此参数将覆盖 GLOBALS 文件中的任何默认 CHECKPOINTTABLE 规范。必须首先使用 ADD CHECKPOINTTABLE 命令添加该表。

对于非 Oracle 目标数据库，指定了 NODBCHECKPOINT 时，复制组将不会向检查点表写入检查点。此参数将覆盖 GLOBALS 文件中的任何默认 CHECKPOINTTABLE 规范。如果不希望对要创建的复制组使用检查点表，则需要此参数。

对于 Oracle AI Database 目标，添加复制时 Oracle GoldenGate 26ai 及更高版本将不支持 NODBCHECKPOINT 参数。升级到 Oracle GoldenGate 26ai 后，如果使用 NODBCHECKPOINT 创建了 Oracle AI Database 的现有 Replicat，但未在 GLOBALS 中指定默认数据库检查点，则 Replicat 在启动时异常终止。为了避免出现这种情况，必须执行以下任一任务：

选项 1 ：Oracle 建议您在 GLOBALS 中指定默认数据库检查点表

或者

选项 2：创建新复制时指定检查点表，并从替换升级的复制的 SCN 重新开始。

DESC ‘description’

指定组的说明，例如 'Loads account_tab on Serv2”。用引号括起说明。

ENCRYPTIONPROFILE

指定复制的加密概要文件的名称。

CRITICAL

指示进程对于部署是否至关重要。

PROFILE

自动启动概要文件的名称。

AUTOSTART

指定当管理服务启动时是否必须自动启动托管进程。默认值为 YES。

DELAY

启动进程之前等待的时间，以秒为单位。

AUTORESTART

控制进程终止时将如何重新启动进程。

RETRIES

取消重试之前重新启动任务的最大尝试次数。此项是可选的。

WAITSECONDS

计算重试次数的持续时间（以秒为单位）。

RESETSECONDS

重置重试次数的计算持续时间。

DISABLEONFAILURE

如果设置为 TRUE，则在重试次数用尽时将禁用该任务。

示例

以下示例添加一个名为 reps 的集成复制。该输出是使用 INFO 命令显示的。

ADD REPLICAT reps, INTEGRATED, EXTTRAIL ea, checkpointtable ggadmin.ckpt1

输出显示如下：

2019-11-21T20:01:10Z  INFO    OGG-08100  REPLICAT (Integrated) added.

下面是添加一个名为 repw 的并行复制的示例。

ADD REPLICAT repw, INTEGRATED, PARALLEL, EXTTRAIL ea, checkpointtable ggadmin.ggs_checkpoint

输出显示如下：

2019-11-21T20:07:26Z  INFO    OGG-08100  REPLICAT (Parallel) added.