添加分发路径

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

何时使用分发路径

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

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

开始之前

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

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

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

创建和运行分发路径 (26ai)

如果使用 GoldenGate 身份证明存储，则必须添加源部署用于连接到目标部署的用户。如果使用 IAM 身份证明存储，请跳过这些步骤。

在 target 部署控制台中，登录，然后从左侧导航访问 User Administration 页面。
选择添加新用户，然后完成以下操作：
- 验证者：从下拉列表中选择密码。
- 角色：从下拉列表中选择运算符。
- 用户名：输入您的用户名。
- Password 和 Verify Password ：输入与此用户关联的密码。
打开 source 部署控制台，然后导航到左侧导航菜单中的 Path Connections 。
选择添加路径连接，然后完成以下操作：
- 身份证明别名：输入别名。
- 用户 ID ：输入在步骤 2 中创建的用户的名称。
- Password（密码）和 Verify Password（验证密码）：输入步骤 2 中与此用户关联的密码。
选择提交。

要在 GoldenGate 26ai 中添加分发路径：

在 OCI GoldenGate 部署控制台主页上，为分发路径选择创建（加号图标）。
在“添加路径”面板中，根据需要填写路径信息字段，然后选择下一步：
1. 输入 Path Name（路径名称），输入路径的名称。
2. （可选）输入说明以描述此路径的目的并列出所涉及的提取和复制。
在源选项页上，根据需要输入字段，然后选择下一步：
- 从下拉列表中选择源提取。
- 输入线索名称
- 如果预计“线索”在非默认位置，请输入子目录。
- 系统会根据提供的信息自动生成生成的源 URI 。如果需要，选择“Edit（编辑）”（铅笔图标）以修改 URI。
- 选择 Encryption Profile（加密配置文件）。如果未创建加密配置文件，则默认情况下会选择本地 Wallet 配置文件。
- 对于开始，选择数据处理的起点：
  - 日志中的位置
  - Now
  - 定制时间
  - CSN（在此或之后）
- 输入序号。
- 输入 RBA 偏移。
在目标选项页上，根据需要填写字段，然后选择下一步：
- 选择目标协议：
  - ws
  - wss
  - ogg
- （可选）启用启用反向代理以使用反向代理连接到目标。
- 目标类型（仅 ogg 目标协议）
  - 经理
  - 收集器
  - 接收方服务
- 输入目标主机。
- 输入目标部署的端口号。
- 输入目标线索文件的线索名称。
- 如果线索位于默认位置以外的某个位置，请输入子目录。
- 输入最大线索大小。
- 选择用于将线索发送到目标部署的目标加密算法：
  - NONE（无）
  - AES128
  - AES192
  - AES256
- 启用更改加密以允许更改加密算法。
- 系统会根据提供的信息自动生成生成的目标 URI 。如果需要，选择“Edit（编辑）”（铅笔图标）以修改 URI。
- 选择 Target Authentication Method（目标验证方法）（仅限 wss 目标协议）
  - 用户 ID 别名
    
    注：从 GoldenGate 身份证明存储部署连接到启用了 IAM 的部署时，使用 IAM 用户创建身份证明。确保用户存在于 IAM 身份条带中。
  - OAuth
    
    注：在启用了 IAM 的租户中，连接到另一个启用了 IAM 的部署时，请选择 OAuth。
  - Certificate (证书)
- 选择域。
- 选择具有 Oracle GoldenGate 用户 ID 和密码的别名。
- 选择目标类型：
  - GGFormat（默认值）
  - SQL
  - XML
  - 纯文本
在高级选项页面上，根据需要填写字段，然后选择下一步：
- 启用 Enable Network Compression 以设置 Compression Threshold 。
- 选择 EOF Delay 。
  
  注：在 Linux 平台上，可以保留默认设置。但是，在非 Linux 平台上，您可能需要针对高带宽、高延迟网络或具有服务质量 (QoS) 设置（DSCP 和服务时间 (ToS)）的网络调整此设置
- 选择 Checkpoint Frequency 以设置获取检查点的路径的频率（秒）。
- 输入 TCP Flush Bytes （字节）。
- 输入 TCP Flush Seconds （秒）。
- 选择区分服务代码点 (Differentiated Services Code Point， DSCP )。
- 选择服务类型 ( TOS )。
- 启用 TCP_NODELAY 以防止在使用 Nagle 选项时延迟。
- 启用 Quick ACK ，以便在接收数据后发送快速确认。
- 启用 TCP_CORK 以允许使用 Nagle 的算法软木塞选项。
- 输入 System Send Buffer Size（系统发送缓冲区大小）以设置流控制的发送缓冲区大小的值。
- 输入 System Receive Buffer Size（系统接收缓冲区大小）以设置流控制的接收缓冲区大小的值。
- 设置 Keep Alive 的超时。
在筛选选项页面上，根据需要填写以下字段，然后选择下一步：
- 输入规则名称。
- 选择规则操作：
  - 排除根据所选选项过滤掉数据。
  - 包括包括基于指定选项的数据。
- 选择 Filter Type（筛选器类型）：
  - 对象类型：从以下三种对象类型中选择：DML、DDL 和过程
  - 对象名称：选择此选项以提供现有对象名称。由 3 部分组成的命名约定取决于您是否使用 CDB。使用 CDB 时，需要使用 3 部分命名约定，否则必须使用 2 部分约定。3 部分约定包括 container、schema、object。2 部分约定包括 schema、object name。
  - 过程功能名称：选择此选项可根据现有过程功能名称进行筛选。
  - 基于列：如果选择此选项，将提供用于输入规则所适用的表和列名的选项。可以使用 LT、GT、EQ、LE、GE、NE 条件的列值进行筛选。您还可以指定要在筛选数据中具有图像之前还是图像之后。
  - 标记：选择此选项可基于标记设置筛选器。
  - 块 ID ：显示数据库分片的配置详细信息，但是无法编辑详细信息。
- 选择否定以否定任何现有规则。
- 选择添加可添加规则。
在托管选项页上，根据需要填写可选字段。
- 启用 Critical 以配置此路径以实现高可用性。
- 启用自动重新启动以调整自动重新启动重试和自动重新启动延迟选项。
选择创建并运行可立即运行路径。选择创建可在以后手动运行路径。

返回到主页，可在其中查看“路径”处理的状态。

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

添加允许源部署（创建此路径的部署）连接到目标部署的身份证明：

在目标部署控制台中，登录，然后从导航菜单访问 Administrator 页面。
选择添加用户，然后创建源部署可用于连接到目标部署的用户。为此用户分配 Operator 角色。
打开源部署控制台，然后导航到配置页。
在“数据库”选项卡下，选择添加身份证明，然后完成以下操作：
- 身份证明域：为此连接输入名称
- 身份证明别名：输入别名
- 用户 ID ：输入在步骤 2 中创建的用户的名称。
- Password（密码）和 Verify Password（验证密码）：输入步骤 2 中与此用户关联的密码。
选择提交。

要添加分发路径，请执行以下操作：

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

返回到“Overview（概览）”页面，可在其中查看“Path（路径）”处理的状态。

了解更多信息

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

已知问题

21.x 部署升级到 21.17 后，分发路径和接收方路径可能会失败

从 Oracle GoldenGate 版本 21.17 和 26ai 开始，Paths 使用默认保留域名 "Network"，因此使用任何其他域名的现有路径将失败，并报告以下错误：

ERROR\| Exception Message: The network connection could not be established: 'OGG-10351' - 'Generic error -1 noticed. Error description - credential store alias not found in domain.'

解决方法：在 OCI GoldenGate 部署控制台中，编辑每个路径并将域名更改为“网络”，然后重新启动路径。要进行验证，请在“配置”页的“身份证明存储”部分中检查路径验证用户的域。

如果您希望使用 Admin Client，请运行以下命令来更新域名。确保替换 <path_name> 和 <alias> 占位符：

对于源启动的路径：

ALTER DISTPATH <path_name> TARGET AUTHENTICATION USERIDALIAS <alias> domain
    Network

对于目标启动的路径：

ALTER RECVPATH <path_name> SOURCE AUTHENTICATION USERIDALIAS <alias> domain
    Network

当前仅支持摘要验证

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

解决方法：无。