添加分发路径

分发路径将数据事务处理从提取发送到复制。

相关主题

何时使用分发路径

需要在分布式部署环境中复制数据时，请使用分发路径。分发路径将数据事务处理从提取发送到复制。创建和运行分发路径将在目标部署的接收方服务中自动创建接收方路径。接收方路径接收来自源部署的分发服务的数据事务处理。

源部署是创建分发路径的部署。目标部署是提取的数据和线索发送到的部署。

开始之前

确保为要连接到的每个部署创建 GoldenGate 连接，然后将它们分配给路径源自的部署。例如，创建分发路径或目标启动的接收方路径的部署。

否则，在启用了 IAM 的部署中，您将遇到以下错误：

The network connection could not be established: 'OGG-08654' - 'Invalid or missing OAuth
      resource - audiencescope in Client application'.

创建并运行分发路径 (23ai)

如果使用 GoldenGate 身份证明存储，则必须添加源部署用于连接到目标部署的用户。如果使用 IAM 身份证明存储，请跳过这些步骤。
  1. 在 target 部署控制台中，登录，然后从左侧导航访问 User Adminstration 页面。
  2. 单击添加新用户，然后完成以下操作：
    • 验证者：从下拉列表中选择密码。
    • 角色：从下拉列表中选择运算符。
    • 用户名：输入用户名。
    • 口令和验证口令：输入与此用户关联的口令。
  3. 打开源部署控制台，然后导航到左侧导航菜单中的路径连接。
  4. 单击添加路径连接，然后完成以下操作：
    • 身份证明别名：输入别名。
    • 用户 ID ：输入在步骤 2 中创建的用户的名称。
    • Password 和 Verify Password ：输入步骤 2 中与此用户关联的密码。
  5. 单击提交。
要在 GoldenGate 23ai 中添加分发路径，请执行以下操作：
  1. 在 OCI GoldenGate 部署控制台中，单击分销服务。
  2. 在主页上，单击添加分发路径（加号图标）。
  3. 在“添加路径”面板中，根据需要填写路径信息字段，然后单击下一步：
    1. 输入路径名称，输入路径的名称。
    2. （可选）输入说明以说明此路径的用途并列出所涉及的提取和复制。
  4. 在源选项页面上，根据需要输入字段，然后单击下一步：
    • 从下拉列表中选择源提取。
    • 输入线索名称
    • 如果希望线索位于非默认位置，请输入子目录。
    • 生成的源 URI 将根据提供的信息自动生成。如果需要，单击“编辑”（铅笔图标）以修改 URI。
    • 选择加密概要信息。如果未创建加密概要信息，则默认选择“本地 Wallet”概要信息。
    • 对于开始，选择数据处理的起点：
      • 日志中的位置
      • Now
      • 定制时间
      • CSN（在此或之后）
    • 输入序号。
    • 输入 RBA 偏移。
  5. 在目标选项页上，根据需要填写字段，然后单击下一步：
    • 选择目标协议：
      • ws
      • wss
      • ogg
    • （可选）启用已启用反向代理以使用反向代理连接到目标。
    • 目标类型（仅限 ogg 目标协议）
      • 管理者
      • 收集器
      • 接收方服务
    • 输入目标主机。
    • 输入目标部署的端口号。
    • 输入目标线索文件的线索名称。
    • 如果线索位于默认位置以外的某个位置，请输入子目录。
    • 输入最大线索大小。
    • 选择用于将线索发送到目标部署的目标加密算法：
      • NONE（无）
      • AES128
      • AES192
      • AES256
    • 启用更改加密以允许更改加密算法。
    • 生成的目标 URI 将根据提供的信息自动生成。如果需要，单击“编辑”（铅笔图标）以修改 URI。
    • 选择目标验证方法（仅限 wss 目标协议）
      • 用户 ID 别名

        注意：

        从 GoldenGate 身份证明存储部署连接到启用了 IAM 的部署时，使用 IAM 用户创建身份证明。确保用户存在于 IAM 身份条带中。
      • OAuth

        注意：

        在启用 IAM 的租户中，连接到另一个启用 IAM 的部署时选择 OAuth。
      • Certificate (证书)
    • 选择域。
    • 选择具有 Oracle GoldenGate UserID 和密码的别名。
    • 选择目标类型：
      • GGFormat（默认）
      • SQL
      • XML
      • 纯文本
  6. 在高级选项页上，根据需要填写字段，然后单击下一步：
    • 启用 Enable Network Compression 以设置 Compression Threshold 。
    • 选择 EOF 延迟。

      注意：

      在 Linux 平台上，可以保留默认设置。但是，在非 Linux 平台上，您可能需要针对高带宽、高延迟网络或具有服务质量 (QoS) 设置的网络（DSCP 和服务时间 (ToS)）调整此设置
    • 选择 Checkpoint Frequency 以设置接受检查点的路径的频率（以秒为单位）。
    • 输入 TCP 刷新字节（以字节为单位）。
    • 输入 TCP 刷新秒（以秒为单位）。
    • 选择区分服务代码点 ( DSCP )。
    • 选择服务类型 ( TOS )。
    • 启用 TCP_NODELAY 以防止在使用 Nagle 选项时出现延迟。
    • 启用快速确认以在接收数据后发送快速确认。
    • 启用 TCP_CORK 以允许使用 Nagle 的算法软木塞选项。
    • 输入 System Send Buffer Size 以设置流控制的发送缓冲区大小的值。
    • 输入 System Receive Buffer Size ，以设置流控制的接收缓冲区大小的值。
    • 设置 Keep Alive 的超时。
  7. 在筛选选项页上，根据需要填写以下字段，然后单击下一步：
    • 输入规则名。
    • 选择规则操作：
      • 排除根据所选选项过滤掉数据。
      • 包括包括基于指定选项的数据。
    • 选择筛选器类型：
      • 对象类型：从以下三种对象类型中进行选择：DML、DDL 和过程
      • 对象名称：选择此选项可提供现有对象名称。3 部分命名惯例取决于您是否使用 CDB。对于 CDB，您需要使用 3 部分命名约定，否则必须使用 2 部分命名约定。3 部分约定包括 container、schema、object。2 部分约定包括 schema、object name。
      • Procedure Feature Name（过程功能名称）：选择此选项可根据现有过程功能名称进行筛选。
      • 基于列：如果选择此选项，则会向您显示用于输入规则适用的表名和列名的选项。您可以将列值与 LT、GT、EQ、LE、GE、NE 条件一起过滤掉。您还可以指定要在已筛选数据中具有图像之前还是图像之后。
      • 标记：选择此选项可基于标记设置过滤器。
      • 块 ID ：显示数据库分片的配置详细信息，但是无法编辑详细信息。
    • 选择否定以否定任何现有规则。
    • 单击添加以添加规则。
  8. 在托管选项页上，根据需要填写可选字段。
    • 启用 Critical 以配置此路径以实现高可用性。
    • 启用 Auto Restart（自动重新启动）以调整自动重新启动重试和自动重新启动延迟选项。
  9. 单击创建并运行可立即运行路径。单击创建以以后手动运行路径。
返回到主页，可在其中查看“路径”处理的状态。

创建并运行分发路径 (21 c )

添加允许源部署（创建此路径的部署）连接到目标部署的身份证明：
  1. 在目标部署控制台中，登录，然后从导航菜单访问 Administrator 页面。
  2. 单击添加用户，然后创建源部署可用于连接到目标部署的用户。为此用户分配 Operator 角色。
  3. 打开源部署控制台，然后导航到配置页。
  4. 在“数据库”选项卡下，单击添加身份证明，然后完成以下操作：
    • 身份证明域：输入此连接的名称
    • 身份证明别名：输入别名
    • 用户 ID ：输入在步骤 2 中创建的用户的名称。
    • Password 和 Verify Password ：输入步骤 2 中与此用户关联的密码。
  5. 单击提交。
要添加分发路径，请执行以下操作：
  1. 在 OCI GoldenGate 部署控制台中，单击分销服务。
  2. 在“分配服务概览”页上，单击添加路径（加号图标）。
  3. 在“添加路径”页面上，按如下方式填写字段：
    1. 对于路径名，输入路径的名称。
    2. （可选）对于说明，输入此路径用途的简要说明。
    3. （可选）启用已启用反向代理以使用反向代理连接到目标。
    4. 对于源，从下拉列表中选择提取名称。
    5. 对于线索名称，从下拉列表中选择“提取”线索。
    6. 对于生成的源 URI ，将根据提供的提取信息自动生成 URI。如果需要，单击“编辑”（铅笔图标）以修改 URI。
    7. 对于目标验证方法，请为目标 URI 选择验证方法：
      • OAuth ：如果源和目标部署启用了 IAM，则选择此选项。此选项使用客户机凭证进行从分发服务到接收器服务的验证。

        注意：

        在启用 IAM 的租户中，连接到其他启用 IAM 的部署时选择 OAuth 。
      • UserID 别名：此选项使用可在目标 Oracle GoldenGate 上创建的 UserID 别名来建立连接。

        注意：

        从 GoldenGate 身份证明存储部署连接到启用了 IAM 的部署时，使用 IAM 用户创建身份证明。确保用户存在于 IAM 身份条带中。
    8. 对于目标，从下拉列表中选择数据传输协议：
      • wss ：Web 套接字安全是缺省选项。如果选中，则必须填写以下字段：
        • 目标主机
        • 端口号
        • 线索名称
        • 部署名称（已启用反向代理）
        • URI 路径（反向代理已启用）
        • 域
        • 别名
      • ogg ：如果选择，必须填写以下字段：
        • 目标主机
        • 端口号
        • 线索名称
        • 部署名称（已启用反向代理）
        • URI 路径（反向代理已启用）
      • ws ：如果选中，则必须填写以下字段：
        • 目标主机
        • 端口号
        • 线索名称
        • 部署名称（已启用反向代理）
        • URI 路径（反向代理已启用）
        • 域
        • 别名
    9. 对于生成的目标 URI ，将使用提供的信息自动填充 URI。如果需要，单击“编辑”（铅笔图标）以修改 URI。
    10. 对于“Target Encryption Algorithm（目标加密算法）”，请为目标线索选择加密算法：
      • 无
      • AES128
      • AES192
      • AES256
    11. 对于启用网络压缩，选择此选项可设置压缩阈值。
    12. 对于序号长度，输入线索序号的长度。
    13. 对于线索大小 (MB) ，输入线索中文件的最大大小。
    14. 对于配置线索格式，如果要配置线索文件格式，请启用此选项，然后根据需要填写其他字段。
  4. 在 "Encryption Profile"（加密配置文件）部分下，根据需要填写以下字段：
    1. 概要文件名
    2. 加密概要文件类型
    3. 主密钥名称
    4. 对于开始，选择记录数据的位置：
      • Now
      • 定制时间
      • 日志中的位置（默认）
    5. 对于源序号，选择线索文件源部署提取的序号。
    6. 对于源 RBA 偏移，在要启动进程的线索文件中输入相对字节地址 (Relative Byte Address，RBA)。
    7. 对于关键，如果分发路径对部署至关重要，则将此选项设置为 True。默认值为假。
    8. 对于自动重新启动，如果希望在分发路径终止时自动重新启动，请将此选项设置为 True。
    9. 对于自动重新启动选项，请指明重新启动路径流程的重试次数以及重试之间的延迟持续时间间隔。
  5. 在“规则集配置”下，根据需要填写以下字段：
    1. 对于启用筛选，如果选中，请单击添加规则，然后填写其他字段。
  6. 在“更多选项”下，根据需要填写以下字段：
    1. EOF 延迟：搜索源数据之前的文件延迟结束
    2. 检查点频率：例程检查点的频率（秒）
    3. 应用程序选项
      • TCP 刷新字节：刷新大小
      • TCP 刷新秒数：刷新间隔
    4. TCP 选项
      • DSCP：网络差异化服务
      • TOS 服务条款
      • TCP_NODELAY：如果启用，则禁止使用 Nagle 的算法
      • 快速确认：如果启用，则发送确认
      • TCP_CORK：允许使用 Nagle 的算法
      • 系统发送缓冲区大小
      • 系统接收缓冲区大小
      • 保持活动：保持活动的超时
  7. 单击创建并运行。
返回到“概览”页，在该页中可以查看“路径”处理的状态。

了解更多信息

有兴趣了解有关分发路径流程的更多信息？请参阅以下资源：

已知问题

要创建分发路径以将数据发送到 Oracle Cloud Infrastructure GoldenGate 或从其提取数据，请确保将根证书添加到证书管理或客户端 wallet

要将数据发送到 OCI GoldenGate 或从其中提取数据，必须在内部部署或市场 Oracle GoldenGate 的接收器服务器上分别创建分发服务器路径或目标启动的路径。还必须将 OCI GoldenGate 根证书或自签名证书添加到 Oracle GoldenGate 证书管理（Oracle GoldenGate 21 c 或更高版本）或客户端 wallet (Oracle GoldenGate 19 c )。这将在 Oracle GoldenGate 和 OCI GoldenGate 部署之间创建可信连接。Oracle GoldenGate 和 OCI GoldenGate 之间的分发和接收器服务器路径仅支持 WebSocket 安全 (WSS) 协议。

更改 OCI GoldenGate 根证书将导致内部部署或市场 Oracle GoldenGate 中接收器服务器上的分发服务器路径或目标启动的路径失败并生成以下错误： 

ERROR   OGG-10390  Oracle GoldenGate Receiver Service:  Generic error -1 noticed for endpoint
      wss://<deployment URL>:443/services/v2/sources?trail=<trail name>. Error description - SSL
      connection unexpectedly closed.

解决方法：要修复此问题，请在客户端 wallet 或 Service Manager 的“证书管理”屏幕中更新证书，以使用 OCI GoldenGate 部署控制台根证书。在某些情况下，当 OCI GoldenGate 部署的证书不是由根证书直接签名，而是由中间证书直接签名时，可能还需要添加中间 CA 证书。

了解详细信息：

当前仅支持摘要验证

使用 Oracle Cloud Infrastructure GoldenGate 作为分发路径目标时，Oracle Cloud Infrastructure GoldenGate 当前不支持基于证书的验证。

解决方法：无。