创建管道资源

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

创建连接

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

注：如果从自治 AI 数据库源复制到非自治 AI 数据库的目标，则必须将源自治 AI 数据库 wallet 解压缩到目标数据库上的 /u01/targetwallet。DBLINK 是从目标数据库创建到源数据库的。

您还可以在创建管道工作流中创建连接源和目标连接。

创建管道

开始之前：

确保：

• 检查源数据库和目标数据库版本。目标数据库版本必须与源数据库相同或更高版本。

• 检查并配置数据库表中的行唯一性，以避免 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;

  此外，对于非自治 AI 数据库，为初始加载添加以下内容：

  GRANT DATAPUMP_EXP_FULL_DATABASE TO GGADMIN CONTAINER=CURRENT;
  GRANT DATAPUMP_IMP_FULL_DATABASE TO GGADMIN CONTAINER=CURRENT;
  GRANT CREATE DATABASE LINK TO GGADMIN CONTAINER=CURRENT;

  对于在非自治 AI 数据库中捕获和应用，请查看为 Oracle 准备数据库用户和权限。

• 检查源数据库上的 DBA_GOLDENGATE_SUPPORT_MODE 视图，该视图显示有关数据库中表的 Oracle GoldenGate 捕获进程支持级别的信息。

• 为 GoldenGate 管道添加最低必需策略。

注:

如果将数据从 Autonomous AI Database 复制到非自治 AI Database，则必须关闭非自治 AI 数据库上的 GLOBAL_NAMES。运行以下命令：

ALTER SYSTEM SET GLOBAL_NAMES = FALSE;

要了解详细信息，请参阅创建从其他数据库到自治 AI 数据库的数据库链接的步骤 4。

要创建管道，请执行以下操作：

1. 在 OCI GoldenGate 概览页面的 GoldenGate 菜单中，选择管道。

   或者，您可以依次选择 Data Fabric 和 Create pipeline 。

2. 在“管道”页上，选择创建管道。

3. 在“创建管道”面板中，按如下方式填写字段，然后选择创建管道：

   1. 对于名称，为管道输入名称。

   2. （可选）对于说明，输入说明以帮助将此管道与其他管道区分开来。

   3. 对于区间，选择要在其中创建管道的区间。

   4. 选择许可证类型。

   5. 从下拉列表中选择源连接和目标连接。

      注:

      • 如果您尚未创建连接，请选择创建连接以开始。

      • 如果将连接与共享端点用作源或目标，则还必须选择子网。

   6. （可选）展开高级选项以配置进程选项：

      • 在进行持续复制之前复制现有数据：选择此选项可执行数据的初始加载。对于现有表，可以选择：

        • 截断：删除现有行，然后从源加载行。

        • 替换：删除现有表，然后从源创建并加载它。

        • 附加：使现有行保持不变，并从源加载行。

        • 跳过：将表保留原样并移至下一个对象。

      • 初始加载类型：选择在开始持续复制之前将完整数据集从源传输到目标的方法：

        • 数据库链接：使用已建立的数据库链接直接将数据从源数据库传输到目标数据库，而无需中间存储。适用于位于同一网络或通过稳定、高速链路连接的数据库。

        • 对象存储：在 Oracle 对象存储中暂存初始加载数据，然后再将其导入目标数据库。适合涉及不同区域或环境中的大量数据的迁移。

          了解有关初始加载类型的更多信息。

      • 替换方案更改 (DDL) ：选择此选项后，选择在进程遇到错误时对现有方案执行的操作：

        • 终止：回退事务处理并停止处理。

        • 放弃：将错误记录到放弃文件并继续处理。

        • 忽略：忽略该错误并继续处理。

      • DML 错误时的操作：选择在进程遇到 DML 错误时对现有数据执行的操作：

        • 终止

        • 放弃

        • 忽略

      • 失败后重新启动：选择此选项可在进程因任何原因停止时启用自动启动。

      • 使用默认映射启动管道：使用默认的 1:1 映射规则在创建后立即启动管道。如果未选中，则可以在创建后配置规则映射，然后手动启动管道。

添加映射规则

要预览、添加或删除映射规则，请执行以下操作：

1. 在 "Pipeline information"（管道信息）页面上，选择 Mapping rules（映射规则）。

2. 在“映射规则”列表中，可以查看或编辑当前映射规则，以及：

   • 预览：查看映射规则如何影响复制中包含的方案和表。

   • 添加：确定要包括或排除的表和方案。您可以使用全限定对象名称或通配符来代替对象名称的任何部分。有关详细信息，请参阅在数据库对象名称中使用通配符。

   • 删除：删除映射规则。

启用管道日志

1. 在管道页上，选择要为其启用日志记录的管道。

2. 在管道详细信息页上，选择日志。

3. 在管道日志列表中，从严重事件操作菜单中选择启用日志。

4. 在 Enable log 面板中：

   1. 对于日志名称，输入名称。

   2. 从区间下拉列表中，选择一个区间。

   3. 对于日志组，您可以：

      • 从下拉列表中选择组

      • 创建新组

      • 将其留空，并自动分配默认组

   4. 对于日志保留，从下拉列表中选择月数。

   5. 选择启用日志。

等待状态变为“Active（有效）”。

启动管道

要启动管道，请执行以下操作：

1. 从管道详细信息页上的操作菜单中，选择开始。

2. 在管道的详细信息页面上，选择初始化。

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

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

   运行时进程显示 Capture 和 Apply 进程的状态及延迟。

已知问题

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

Pipeline 选项“在开始复制之前将现有数据复制到目标数据库”使用 Oracle Data Pump。如果目标数据库的时区文件版本低于源数据库，则 Oracle Data Pump 将失败。

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