ADD SCHEMATRANDATA

对 Oracle 有效。

使用 ADD SCHEMATRANDATA 可以为表启用方案级别补充日志记录。ADD SCHEMATRANDATA 对给定方案中所有当前和将来的表执行操作的操作，以自动记录 Oracle GoldenGate 进行行标识所需的可用键的超集。

注：Oracle GoldenGate 23.6 不支持在方案级别为 JSON Relational Duality Views (JSON DV) 和 JSON Collection Tables (JCT) 启用逻辑复制。

要对多租户数据库的 PDB 中的方案执行 ADD SCHEMATRANDATA，您需要登录到 PDB 以发出命令。

ADD SCHEMATRANDATA 对提取有效，并执行以下操作：

为使用 CREATE TABLE 创建的新表启用 Oracle 补充日志记录。
更新受 ALTER TABLE（添加或删除列）影响的表的补充日志记录。
更新已重命名表的补充日志记录。
更新为其添加或删除唯一键或主键的表的补充日志记录。
为表启用自动捕获。该命令添加方案级别 PK、UI、FK、ALLKEYS 补充日志记录数据。

默认情况下，ADD SCHEMATRANDATA 按以下优先级顺序记录表的键列：

主键
（在没有主键的情况下）表的所有唯一键，包括已禁用、不可用或不可见的唯一键。此外，还会记录包含 ADT 成员列的唯一键。只有虚拟列（基于函数的索引）上的唯一键不会被记录。
如果以上都不存在，则记录表的所有标量列。（始终记录系统生成的行 OID。）

ADD SCHEMATRANDATA 还支持使用集成复制的条件或无条件日志记录要求。

在以下情况下使用 ADD SCHEMATRANDATA：

对于属于要配置为支持集成捕获的提取组的所有表。ADD SCHEMATRANDATA 通过记录所有键确保记录正确的键。
对于将在集成复制组中处理的所有源表。提供了支持记录主键、唯一键和外键的选项，以支持通过不同的应用服务器处理的关系表之间的相关项计算。
当 DDL 复制处于活动状态并且 DML 与创建新表或变更键列的 DDL 并发时。它最适合处理在对象上发出 DDL 后不久就可以将 DML 应用于对象的情况。ADD SCHEMATRANDATA 使相应的键值随每个 DDL 操作以原子方式记录在重做日志中，从而确保从日志捕获 DML 时的元数据连续性，而不受提取处理中任何滞后。

UsingADD SCHEMATRANDATA 的数据库级日志记录要求

Oracle 强烈建议在使用 Oracle GoldenGate 时，将源数据库置于强制日志记录模式，并在数据库级别启用最少补充日志记录。这样，在执行更新操作时，会将行链接信息（如果存在）添加到重做日志中。

UsingADD SCHEMATRANDATA 的其他注意事项

使用 ADD SCHEMATRANDATA 之前，发出 DBLOGIN 命令。必须为发出该命令的用户授予 Oracle Streams 管理员权限。
```
EXEC DBMS_STREAMS_AUTH.GRANT_ADMIN_PRIVILEGE('*GGADMIN*')
```
未启用 DDL 复制时，ADD SCHEMATRANDATA 可用于替代 ADD TRANDATA 命令。但是请注意，如果一个表没有主键，但有多个唯一键，则 ADD SCHEMATRANDATA 会导致数据库记录所有唯一键。在此类情况下，ADD SCHEMATRANDATA 导致数据库记录的重做数据比 ADD TRANDATA 记录的重做数据多。为了避免额外的日志记录，可以将其中一个唯一键指定为主键（如果可能）。
对于具有一个主键、一个唯一键或没有键的表，与 ADD TRANDATA 相比，ADD SCHEMATRANDATA 不会增加额外的日志记录开销。
如果在 PDB 中的方案上添加 SCHEMATRANDATA，则需要使用 DBLOGIN 登录到该 PDB。例如，对于 PDBEAST 和方案 HR，使用以下命令：

ADD SCHEMATRANDATA pdbeast.hr
If you must log additional, non-key columns of a specific table (or tables) for use by Oracle GoldenGate, such as those needed for FILTER statements and KEYCOLS clauses in the TABLE and MAP parameters, issue an ADD TRANDATA command for those columns. 该命令有一个 COLS 选项，用于为列发出表级别补充日志记录，并且可以与 ADD SCHEMATRANDATA 结合使用。

语法

ADD SCHEMATRANDATA schema
{
[ALLOWNONVALIDATEDKEYS]
[NOSCHEDULINGCOLS | ALLCOLS]}
[NOVALIDATE]
[PARTIALJSON]
[PREPARECSN  {WAIT | LOCK | NOWAIT | NONE}]

schema

要为其记录补充键信息的方案。请不要使用通配符。要为多租户容器数据库的多个可插入数据库中的方案发出 ADD SCHEMATRANDATA，请使用 DBLOGIN 分别登录到每个可插入数据库，然后发出 ADD SCHEMATRANDATA。从根 conatiner 中，可以随容器前缀 ADD SCHEMATRANDATA [pdb_name].schema 添加 schemamatrandata

如果从 cdb$root 运行该命令，请确保还在数据库端设置以下用户权限：

ALTER USER userID SET CONTAINER_DATA = ALL  CONTAINER = CURRENT;

ALLOWNONVALIDATEDKEYS

它在补充日志记录中包含 NON VALIDATED 和 NOT VALID 主键。这些键将覆盖 Oracle GoldenGate 使用的常规键选择标准。如果使用 GLOBALS 参数 ALLOWNONVALIDATEDKEYS，则无论是否指定，ADD SCHEMATRANDATA 都将与 ALLOWNONVALIDATEDKEYS 一起运行。默认情况下，不会记录 NON VALIDATED 和 NOT VALID 主键，请参见 GLOBALS ALLOWNONVALIDATEDKEYS 参数。

NOSCHEDULINGCOLS | ALLCOLS

这些选项用于控制 Oracle 目标数据库的补充日志记录。虽然将使用后一选项，但是可以结合使用这些选项。例如，对于 ADD SCHEMATRANDATA oggadm_ext ALLCOL NOSCHEDULINGCOLS 命令，将使用 NOSCHEDULINGCOLS 选项。

NOSCHEDULINGCOLS

禁用调度列的日志记录。默认情况下，ADD SCHEMATRANDATA 启用对给定方案中的所有当前和将来表的所有唯一键和外键的无条件日志记录，以及对其中所有当前和将来表的条件补充日志记录。无条件日志记录强制将主键值写入日志，无论该键在当前操作中是否已更改。如果在当前操作中至少更改了外键或唯一键之一，则条件日志记录将记录外键或唯一键的所有列值。集成复制主键、唯一键和外键都必须对入站服务器可用，才能计算相关项。

如果启用 auto_capture，则不使用此选项。这样就可以自动捕获此方案中的表，除非明确排除/禁用表（例如通过 TABLEEXCLUDE、DELETE TRANDATA 或 ALTER TABLE DISABLE LOGICAL REPLICATION DDL）。

ALLCOLS

对给定方案中所有当前和将来表的所有受支持键和非键列启用无条件补充日志记录。此选项支持记录计算相关项所需的键，以及筛选、冲突解决或其他目的所需的列。不包括 LOB、LONG 和 ADT 等列。

NOVALIDATE

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

禁止显示有关 ADD SCHEMATRANDATA 正在处理的表的其他信息。默认情况下，此选项是启用的。其他信息处理会产生命令响应用时，因此，可以使用此选项增加响应时间。

PARTIALJSON

对 Oracle 有效。

在方案级别提取部分 JSON 更新。如果启用，重做将包含部分 JSON 记录。

另请参见 TRANLOGOPTIONS FETCHPARTIALJSON 参数。

PREPARECSN {WAIT | LOCK | NOWAIT | NONE}

对 Oracle 的 DML 和 DDL 都有效。

自动在源中准备表，以便 Oracle 数据泵导出转储文件将包含实例化 CSN。复制使用 Oracle 数据泵（在导入时）设置的按表实例化 CSN 以筛选出线索记录。在目标中，数据泵导入通过 DBOPTIONS ENABLE_INSTANTIATION_FILTERING 参数启用表级别实例化筛选，使用实例化 SCN 填充系统表和视图。

WAIT

等待任何正在运行的事务处理并准备表实例化。

LOCK

锁定表（以准备表实例化）。

NOWAIT

默认行为，实例化准备立即完成。

NONE

未进行实例化准备。

示例

以下示例为方案 hr 启用补充日志记录。

ADD SCHEMATRANDATA hr

以下示例记录名为 hr 的方案中所有当前和将来表所有受支持键和非关键字列。

ADD SCHEMATRANDATA hr ALLCOLS

以下示例禁止显示其他表信息处理。

ADD SCHEMATRANDATA hr NOVALIDATE