创建管道资源

了解如何创建使用管道所需的资源。

相关主题

创建连接

OCI GoldenGate 管道当前仅支持具有专用端点和 mTLS 验证的 Oracle Autonomous AI Database 。为了获得最佳效果，请使用 Autonomous AI Transaction Processing 作为源数据库，使用 Autonomous AI Lakehouse 作为目标数据库。

在创建管道之前，请确保首先为 GoldenGate 准备数据库，然后创建与源数据库和目标数据库的连接。请参阅连接到 Oracle Autonomous AI Database 。

创建管道

开始之前：
请确保：
  • 复核和配置数据库表中的行唯一性，以避免通过 ZeroETL 镜像出现主键问题。主键唯一地标识数据库表中的记录或行。请参阅确保源表和目标表中的行唯一性。
  • 作为对目标数据库具有管理权限的用户，将以下权限授予 GGADMIN 用户进行 ZeroETL 镜像：
    GRANT DWROLE TO GGADMIN;
GRANT DATAPUMP_CLOUD_EXP TO GGADMIN;
GRANT DATAPUMP_CLOUD_IMP TO GGADMIN;
GRANT EXECUTE ON DBMS_CLOUD_ADMIN TO GGADMIN;
GRANT CREATE DATABASE LINK TO GGADMIN;
  • 检查源数据库上的 DBA_GOLDENGATE_SUPPORT_MODE 视图，该视图显示有关数据库中表的 Oracle GoldenGate 捕获进程支持级别的信息。
  • 为 GoldenGate 管道添加所需的最低策略。
  • 您用于管道的源连接和目标连接具有专用端点。
要创建管道，请执行以下操作：
  1. 在 OCI GoldenGate “概览”页上，单击 GoldenGate 菜单中的管道。

    或者，您可以依次单击数据结构和创建管道。

  2. 在“管道”页上，单击创建管道。
  3. 在“创建管道”面板中，按如下方式填写字段，然后单击创建管道：
    1. 对于名称，输入管道的名称。
    2. （可选）对于说明，输入说明以帮助区分此管道与其他管道。
    3. 对于区间，选择要创建管道的区间。
    4. 选择许可证类型。
    5. 从下拉列表中选择源连接和目标连接。

      注意：

      管道当前仅支持与专用端点的连接。
    6. （可选）单击显示高级选项以配置流程选项：
      • 在进行中的复制之前复制现有数据：选择此选项可执行数据的初始加载。对于现有表，可以选择：
        • 截断：删除现有行，然后从源加载行。
        • 替换：删除现有表，然后从源创建并加载它。
        • 附加：保留现有行不变，然后从源加载行。
        • 跳过：将表保留原样并移至下一个对象。
      • 替换方案更改 (DDL) ：选择此选项后，选择在进程遇到错误时对现有方案执行的操作：
        • 终止：回退事务处理并停止处理。
        • 放弃：将错误记录到放弃文件并继续处理。
        • 忽略：忽略错误并继续处理。
      • 发生 DML 错误时的操作：选择在进程遇到 DML 错误时对现有数据执行的操作：
        • 终止
        • 放弃
        • Ignore
      • 失败后重新启动：选择此选项可在进程因任何原因停止时启用自动启动。
      • 使用默认映射启动管道：使用默认的 1:1 映射规则在创建后立即启动管道。如果未选择，您可以在创建后配置规则映射，然后手动启动管道。

添加映射规则

要预览、添加或删除映射规则，请执行以下操作：
  1. 在“管道信息”页上，选择映射规则。
  2. 在“映射规则”列表中，您可以查看或编辑当前映射规则，并且：
    • 预览：查看映射规则如何影响复制中包含的方案和表。
    • 添加：标识要包括或排除的表和方案。可以使用全限定对象名称或通配符代替对象名称的任何部分。有关更多信息，请参见 Using Wildcards in Database Object Names。
    • 删除：删除映射规则。

启用管道日志

  1. 在管道页上，选择要为其启用日志记录的管道。
  2. 在管道详细信息页上，选择日志。
  3. 在管道日志列表中，从“严重事件”“操作”菜单中选择“启用日志”。
  4. 在启用日志面板中：
    1. 对于日志名称，输入名称。
    2. 从区间下拉列表中，选择一个区间。
    3. 对于日志组，您可以：
      • 从下拉列表中选择组
      • 创建新组
      • 将其留空，并自动分配默认组
    4. 对于日志保留期，请从下拉列表中选择月数。
    5. 单击启用日志。
等待状态变为“Active（活动）”。

启动管道

要启动管道，请执行以下操作：
  1. 从管道详细信息页上的操作菜单中，选择开始。
  2. 在管道的详细信息页上，选择初始化。

    初始化步骤显示管道步骤的当前状态。对于每个步骤，您可以从其操作菜单中选择查看详细信息并查看相应的消息。

  3. 管道的状态为“活动”（正在运行）后，选择运行时。

    运行时进程显示捕获和应用进程的状态和延迟。

已知问题

ZeroETL 镜像管道应用进程失败

如果管道应用进程失败，但 OCI 日志记录中出现以下错误：
Error mapping from ADMIN.DBTOOLS$EXECUTION_HISTORY to <ADB ID>.ADMIN.DBTOOLS$EXECUTION_HISTORY.

解决方法：使用 ADMIN.* 创建排除规则，然后重新启动管道。

如果目标数据库时区文件版本低于源数据库的时区文件版本，则 Oracle Data Pump 将失败

Pipeline 选项 "Copy existing data to target database before start replication"（在开始复制之前将现有数据复制到目标数据库）使用 Oracle Data Pump。如果目标数据库的时区文件版本低于源数据库的时区文件版本，则 Oracle Data Pump 将失败。

解决方法：要解决此问题，必须升级目标数据库的时区版本。请参阅在 Autonomous Database 上管理时区文件更新。