添加提取

了解添加提取的先决条件和注意事项。

在开始添加提取之前，请确保已配置以下设置：

现在，您已准备好为您的部署添加提取。

存在以前的提取线索文件时创建提取的注意事项

提取信息屏幕

登录到微服务主页后，单击“创建”列中的 + 符号以打开添加提取向导。

在提取信息屏幕上，选择提取的类型。根据数据库平台，可用的提取类型可以是集成提取、更改数据捕获提取和初始加载提取。

如果需要为 Oracle AI Database 设置 Downstream Extract ，请启用 Downstream Extract 切换开关。

选择要创建的提取类型，并指定以下内容：

单击下一步。

注册提取屏幕 - PostgreSQL 和 Yugabyte 数据库

注：需要注册 Oracle GoldenGate Extract for Oracle、不同的 PostgreSQL 风格和 Yugabyte 数据库。但是，在添加提取时，用于注册提取的配置选项将显示在不同的屏幕上。

注：另请参阅 PGOUTPUT 插件类型的准则和限制。

在注册提取屏幕上，配置以下选项，然后单击注册：

成功注册提取后，单击下一步。

此时将显示一条消息，指出提取已成功注册。

单击下一步。

从管理客户端注册 PostgreSQL 和 Yugabyte 数据库的提取

PostgreSQL 的提取必须注册到数据库并被授予保留的复制插槽。复制插槽通过数据库配置设置 max_replication_slots 进行分配，并且可以按照 Database Configuration 中所述进行配置。

按照以下说明注册提取。必须在创建提取之前完成提取注册。有关更多信息，请参见 Command Line Interface Reference for Oracle GoldenGate 中的 REGISTER EXTRACT 。

  1. 连接到部署，然后连接到源数据库的身份证明别名。

    CONNECT http*s*://*remotehost*:*srvmgrport* DEPLOYMENT

          *deployment_name* AS *deployment_user* PASSWORD *deployment_password*
    OGG (https://*remotehost*:*16000**postgresql_source*)> DBLOGIN USERIDALIAS *alias*

  2. 注册提取，该提取在内部为提取创建复制插槽。提取名称不能超过 8 个字母数字字符。

    REGISTER EXTRACT *extname*

    要使用 pgoutput 插件显式注册 Extract，必须指定 pgoutput 插件类型：

    REGISTER EXTRACT *extname* PGPLUGINTYPE pgoutput;

您还可以从 Oracle GoldenGate MA Web 界面注册提取。请参阅添加提取。

PGOUTPUT 插件类型的准则和限制

配置 PGOUTPUT 插件类型的准则

设置 PostgreSQL 的插件类型时，请遵循以下准则：

限制

为 PostgreSQL 选择插件类型时适用以下限制：

提取选项屏幕

注：此屏幕提供了用于为 Oracle AI Database 注册提取的选项。如果要为 PostgreSQL 添加提取，则将在“注册提取”屏幕上完成提取注册。

在 Extract Options 屏幕上配置以下设置：

从管理客户端注册 Oracle 提取

按照以下说明注册提取。必须在创建提取之前完成提取注册。

确保已使用 DBLOGIN 命令与数据库连接。

有关更多信息，请参见 Command Line Interface Reference for Oracle GoldenGate 中的 [REGISTER EXTRACT](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GCLIR-GUID-5E42DB9E-EFDF-40C0-89D7-88413496B8A3)。

  1. 使用管理客户机连接到部署，然后连接到源数据库的身份证明别名。

    OGG> CONNECT https://*remotehost*:*srvmgrport* DEPLOYMENT *deployment_name* AS *deployment_user* PASSWORD *deployment_password*

    运行 CONNECT 命令时，命令提示符从 "not connected"（未连接）更改为 "https://servername:port deployment_name"，如以下示例所示：

    OGG (https://*pdbeast.vcn.oracle.com*:*16000**depl_east*)>

  2. 使用 DBLOGIN 命令连接到数据库：

    OGG (https://*remotehost*:*port**oracle_source*)> DBLOGIN USERIDALIAS *alias*

  3. 注册提取。提取名称不能超过 8 个字母数字字符。

    OGG (https://*remotehost*:*port**oracle_source*)> REGISTER EXTRACT *extname* DATABASE

您还可以在后台注册提取，同时从 Oracle GoldenGate MA Web 界面创建提取。有关详细信息，请参阅添加提取。

下游捕获屏幕

仅对 Oracle 有效。

如果在 Extract Information 屏幕上选择了 Downstream Capture ，则会显示 Downstream Capture 选项屏幕。使用此屏幕为下游提取配置下游挖掘数据库连接。

注：具有 ADG 的下游捕获不支持按 PDB 提取。

单击下一步。

“托管选项”屏幕

在 Managed Options（托管选项）屏幕上，配置提取流程的自动启动和自动重新启动选项。下表提供了以下选项：

下表提供了以下选项：

选项 说明
概要文件名

提供自动启动和自动启动配置文件的名称。您可以选择默认或自定义选项。

如果已创建配置文件，则还可以选择该配置文件。如果选择“定制”选项，则可以从此部分本身设置新概要。
对于部署的健康状况至关重要

（仅限 Oracle）如果概要信息对部署健康状况至关重要，请启用此选项。

注意：

此选项仅在创建“提取”或“复制”时显示，在“概要”页面中设置受管理处理时不显示。

自动启动 为流程启用自动启动。
启动延迟 启动进程之前等待的时间，以秒为单位
自动重新启动 配置在进程终止时如何重新启动进程
最大重试数 指定尝试启动进程的最大重试次数
重试延迟 延迟尝试启动进程的时间
重试窗口 尝试启动流程的持续时间间隔
仅在失败时重新启动 如果为 true，则任务仅在失败后才重新启动。
在重试次数用完后禁用任务 如果为 true，则在用尽重新启动进程的所有尝试后，任务将被禁用。

单击下一步。

提取参数文件屏幕

在参数文件屏幕上，您可以编辑文本区域中的参数文件，以列出您感兴趣的捕获表详细信息。下面是一个提取参数文件示例：

EXTRACT exte
USERIDALIAS ggeast DOMAIN OracleGoldenGate
EXTTRAIL east/ea
DDL INCLUDE MAPPED
TABLE hr.*;

单击创建并运行以创建并启动提取。如果选择创建，则会创建提取，但您需要使用“提取”选项启动提取。

返回到“管理服务”主页或“提取”页面，其中列出了所有创建的提取。

创建要提取的参数文件

请按照以下说明为提取创建参数文件。

  1. （仅限 MySQL）在 Windows 服务器和 Linux 服务器（OGG 版本低于 23.10.x）上运行 Oracle GoldenGate for MySQL 时，该服务器位于远程主机上数据库服务器，确保其时区相同，如果不同，请使用提取中的 SETENV(TZ) 参数并将其设置为数据库服务器的时区。

    有关 TZ 格式和更多详细信息，请参阅参数和函数参考指南中的 SETENV 参数。

    请参阅以下链接以获得参考：

    https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/tzset?view=msvc-170#remarks

    https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html

  2. 在源系统上，发出以下命令：

    EDIT PARAMS extract_name

    其中：

    extract_name 是您使用 ADD EXTRACT 命令创建的提取的名称，或者是参数文件的全限定名称（如果您在创建组时定义了备用位置）。

  3. 按下表中显示的顺序输入参数，为每个参数语句开始一个新行。某些参数仅适用于某些配置。

    参数 说明
    EXTRACT group
    • group 是使用 ADD EXTRACT 命令创建的 Extract 组的名称。
    		将提取配置为具有检查点的联机流程。
    [, USERIDALIAS alias options ] 要指定数据库身份证明，请参见 [USERIDALIAS](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GWURF-GUID-530D7773-B66D-4499-A509-EF5BB9CE9B05)。
    ENCRYPTTRAIL algorithm 对在此条目之后指定的所有线索进行加密。
    SOURCECATALOG 指定 Oracle 多租户容器数据库或 SEQUENCE 语句中的默认容器。允许使用两部分名称 (schema.object)，否则这些数据库需要三部分名称。可以使用此参数的多个实例为不同的 TABLE 或 SEQUENCE 参数集指定不同的默认容器或目录。
    TABLE [container. \| catalog.]owner.object \| schema.object \| library/file \| library/file(member);

    为多个对象指定对象的全限定名称或全限定通配符指定。如果数据库是 Oracle 多租户容器数据库，则对象名称必须包括容器或目录的名称，除非使用 SOURCECATALOG。

    • schema 是方案名称或一组通配符的方案。

    • object 是表名或通配符的表集合。

    • library 是 IBM i 库名称或通配符的库集。

    • file 是 IBM i 物理文件名或通配符的物理文件集。

    • member 是 IBM i 物理文件成员名称或通配符成员名称集。使用 IBM i 本机名称格式（带有可选成员的库/文件）时，唯一有效的通配符是具有至少一个有效字符的名称，后跟与任何名称匹配的尾随星号 (*) 或 *ALL。

    注意：

    成员名称是可选的，如果成员名称必须作为对象名称的一部分写入线索，则必须提供该名称。如果不指定成员名称，则物理文件中的所有成员将隐式合并为线索中的单个对象。

    请参阅在 Oracle GoldenGate 输入中指定对象名称准则，以指定参数文件中的对象名称。

    SCHEMAEXCLUDE

    TABLEEXCLUDE

    EXCLUDEWILDCARDOBJECTSONLY

    		 可相互结合使用的参数，用于从关联的 TABLE 语句中的通配符规范中排除特定对象。

  4. 输入 Oracle GoldenGate 参数中列出的任何适当的可选提取参数。

  5. 保存并关闭参数文件。

以下提取参数文件样例说明了提取的各种配置参数和选项：

ADD EXTRACT *extract_name*
{, datasource}
{, BEGIN start_point} | {position_point}
[, PARAMS pathname]
[, REPORT pathname]
[, DESC 'description']

提取的其他参数选项

了解提取配置可能需要的其他参数。

提取使用挖掘数据库中的数据库日志挖掘服务器来挖掘源数据库的重做流。通过将 TRANLOGOPTIONS 参数与提取参数文件中的 INTEGRATEDPARAMS 选项结合使用，可以设置特定于日志挖掘服务器的参数。

注：有关这些参数的详细信息和使用指南，请参阅 Oracle AI Database PL/SQL Packages and Types Reference 中的 "DBMS_CAPTURE_ADM" 部分。

可使用 INTEGRATEDPARAMS 设置以下参数：

请参见 Managing Server Resources 。