维护 OCI GoldenGate 部署

了解 GoldenGate 版本、如何以及何时升级、接收或推迟通知以及如何回滚升级。

关于 GoldenGate 版本

OCI GoldenGate 支持多个并发版本，例如 Oracle GoldenGate 、Oracle GoldenGate for Big Data 和 Oracle GoldenGate for MySQL。有关适合您的版本的详细信息，请参阅版本参考。

每个版本都有一个构建编号。发行版有三种类型：

• Major ：内部版本号中的第一个数字表示主发行版。例如： 21。
• 捆绑包：第二个数字表示捆绑包发行版。捆绑包发行版是主要发行版的一组 bug 修复。例如： 21。5
• 次要：尾随编号表示次要发行版。次要发行版包含捆绑包发行版上的一个或多个 bug 修复。例如： 21.5。0.0.0。

注意：

所有发行版类型都可以包含安全修复。

根据发行版的类型以及它是否包含安全修复，当新版本可用时，您有特定时间来升级部署：

发行版类型	主要	包	次要
非安全修复	365 天	180 天	不适用
安全修复	不适用	14 天	14 天

如果您未在给定时间范围内手动升级，则您的部署将在此时间范围结束时自动升级到最新版本。

注意：

您可以在“升级部署”屏幕和“升级”列表中查看支持版本的日期。

版本弃用

GoldenGate 版本自发布之日起到弃用之日起提供。版本过时后，无法再选择该版本进行部署创建或升级。

弃用期间使用与版本升级相同的时间范围。例如：

• 重大版本发布后 365 天，先前的主要版本已过时。
• 捆绑包版本发布 180 天后，同一主要发行版的先前捆绑包版本已过时。
• 在安全修复发行版（对于捆绑包或次要发行版）发布 14 天后，同一主要发行版的所有先前版本都已过时。

注意：

区域之间的发布日期可能不同。

安排升级

您可以自定义维护窗口，以定义在有新的 GoldenGate 版本可用时升级部署的时段的开始时间。如果您未定义维护窗口，则 OCI GoldenGate 将根据最新版本的发布日期计算升级部署的最佳时间。

注意：

如果未定义维护窗口， OCI GoldenGate 将在最接近自动升级期间计算结束的周末进行升级。

您可以在创建部署时自定义 OCI GoldenGate 维护窗口，也可以稍后从部署详细信息页面中自定义。当有新的 GoldenGate 版本可用时，部署将在选择的确切日期和时间自动升级。但是，当新版本用于手动升级的时间范围超出定制维护窗口时，部署可以在您选择的日期和时间之前自动升级。

例如，假设在 2023 年 1 月 1 日，您还有 30 天时间来升级部署，则需要到 1 月 31 日星期二手动升级。但是，您的定制维护窗口将于星期日下午 10 点开始。使用此维护窗口， OCI GoldenGate 将在 2 月 4 日星期日下午 10 点升级您的部署，因为 OCI GoldenGate 将始终优先考虑您的定制窗口。

要编辑自定义维护窗口，请执行以下操作：

1. 在部署详细信息页上的“部署信息”区域的 GoldenGate 下，单击编辑以进行维护。
2. 在“编辑维护参数”对话框中：
   1. （可选）选择自定义维护窗口以更改以下字段的默认值。
   2. 对于主发行版自动升级期间（天），输入介于 0 和 365 之间的值。
   3. 对于捆绑包发行版自动升级期间（天），输入介于 0 和 180 之间的值。
   4. 对于安全路径自动升级期间（天），输入介于 0 和 14 之间的值。
   5. （可选）选择 Enable minor release auto-upgrade ，然后为 Minor release auto-upgrade period（天）输入值。
3. 单击保存更改。

升级之前的准备工作

在升级部署之前，请确保完成以下任务并检查长时间运行的事务处理。

确保归档日志可用于恢复

在 Admin Client 中使用以下命令来确定提取启动时可能需要恢复的最早归档日志。Recovery Checkpoint 字段显示恢复所需的最早日志。

Admin Client > INFO EXTRACT group_name, SHOWCH

最好在高峰时段之外执行升级活动。如果存在长时间运行的大量事务，则可以考虑在源系统上，新提取可能需要从正常恢复检查点开始处理，而超过有界恢复检查点，如果停止提取时最早的未结事务处理的第一条记录在不位于系统的日志中。

清除长时间运行的事务处理

要清除长时间运行的事务处理，您有两个选项：

• 您可以将归档文件恢复回恢复检查点中显示的归档文件，并包括归档文件：

  Admin Client > INFO EXTRACT

  （如果源数据库支持此功能。）
• 您可以清除应用于要升级的提取的长时间运行的事务处理。这可以通过跳过事务处理或强制它们作为已提交的事务处理进入线索来实现。跳过事务处理可能会导致数据丢失，如果回退事务处理，则强制将事务处理添加到线索中可能会添加不需要的数据。要跳过或强制执行事务处理，请执行以下操作：
  1. 查看未结事务处理：

     Admin Client > SEND EXTRACT group_name, SHOWTRANS

  2. 记录要清除的任何事务处理的事务处理 ID。
  3. 使用 SEND EXTRACT 和 SKIPTRANS 选项清除旧事务处理以跳过事务处理，或者使用 FORCETRANS 将处于当前状态的事务处理强制作为已提交的事务处理进入线索。例如：

     Admin Client > SEND EXTRACT group_name, {SKIPTRANS | FORCETRANS transaction_ID [THREAD n] [FORCE]

  4. 完成长时间运行的事务处理的清理后，强制执行有边界恢复检查点。

     Admin Client> SEND EXTRACT group_name, BR BRCHECKPOINT IMMEDIATE

同步复制

对于具有并行复制的部署，请确保在升级之前同步复制：

Admin Client > SYNCHRONIZE REPLICAT group_name

有关更多信息，请参见 SYNCHRONIZE REPLICAT 命令行界面参考。

升级部署

确保首先完成升级之前步骤。

升级部署时，

• 部署将停止，然后在升级完成后重新启动。
• 所有 Oracle GoldenGate 进程都将停止，然后重新启动（如果它们配置为自动启动）。

要升级部署，请执行以下操作：

1. 在“部署”页上，选择要升级的部署。
2. 在部署详细信息页上，从操作菜单中，选择升级。
3. 在升级部署面板中，选择要升级到的可用 GoldenGate 版本，然后单击升级。

   注意：

   单击此处的链接，可以了解有关版本的更多信息。

完成升级需要几分钟时间。在升级完成后，单击部署详细信息页上的升级以查看升级历史记录，或者在升级过程中是否遇到问题。

升级心跳表

如果您的部署中使用了脉动表，则还必须升级这些表。完成升级后，您可以：

• 在 Admin Client 中运行 UPGRADE HEARTBEATTABLE 命令，为表和滞后视图添加额外的列。GoldenGate 使用这些附加列跟踪提取重新启动位置。了解更多信息。
• 在部署控制台中，打开管理控制台的导航菜单，然后单击“配置”。连接到数据库。显示 "Heartbeat" 表时，从 "Action" 菜单中选择 "Upgrade"。

升级通知

OCI GoldenGate 会向您发送有关何时提供升级以及何时安排升级的事件通知。有关更多信息，请参见 GoldenGate Upgrade Event types ，或了解有关事件的更多信息。

升级时间	< 180 天	< 30 天	< 7 天
通知期间	每 30 天	每 7 天	每日

注意：

OCI GoldenGate 每天都会发送安全修复通知。

您还可以从部署详细信息页面上显示的通知横幅了解即将进行的升级。

暂缓发送通知

您可以推迟或推迟事件和横幅通知。随着您接近手动升级的时间范围结束，闲置期间会发生变化。

升级时间	< 180 天	< 30 天	< 7 天
暂停期间	30 天	7 天	不允许

注意：

不允许为次要升级或捆绑包升级的安全修复暂停。

您可以随时取消闲置。

回退升级

您可以将部署版本回退到上一个版本。仅当您最近成功升级到其先前版本时才允许回退。

注意：

在回退期间，部署文件系统在升级之前将恢复到上次状态。

当以前的版本已过时时，不允许回退。

要回退升级，请执行以下操作：

1. 在“部署”页中，选择要回退的部署。
2. 在部署详细信息页上，选择升级。
3. 在 "Upgrades"（升级）列表中，找到最新的先前版本，然后从其 "Action"（操作）菜单中选择 Rollback（回退）。
4. 选择要回退到的版本，然后单击回退。

   注意：

   有关可用版本列表，请参阅版本参考。

您的部署的状态将更改为更新，并且需要几分钟才能完成。

重新安排升级

您可以重新安排自动安排的升级。您可以将升级重新安排到更近的日期或将其推迟到更晚的日期。

注意：

重新计划不会考虑维护窗口。您的新计划日期不能晚于 OCI GoldenGate 的定义值。有关详细信息，请参阅关于 GoldenGate 版本。

要重新调度升级，请执行以下操作：

1. 从“部署”页中，选择要重新安排其升级的部署。
2. 在部署详细信息页上，选择升级。
3. 在 "Upgrades"（升级）列表中，找到最新的先前版本，然后从其 "Action"（操作）菜单中选择 Reschedule（重新调度）。
4. 在“重新计划部署升级”窗口中，选择执行升级的日期和时间。
5. 单击保存更改。

在“升级”列表中，计划日期和时间反映了更改。

取消升级

仅当目标版本是次要发行版时，才能取消自动安排的升级。

注意：

取消次要发行版的升级不会隐式禁用次要发行版的自动升级，必须手动禁用。您可以从部署详细信息页面禁用次发行版自动升级。有关详细信息，请参阅调度升级。

要取消升级，请执行以下操作：

1. 在“部署”页中，选择要取消其升级的部署。
2. 在部署详细信息页上，选择升级。
3. 在 "Upgrades"（升级）列表中，找到最新的先前版本，然后从其 "Action"（操作）菜单中选择 Cancel（取消）。
4. 在“取消部署升级”窗口中，单击取消部署升级。

升级的状态将更新为“已取消”。

已知问题

从 21.15 或 23.x 构建回退到 21.14 期间遇到的问题

尝试将 21.15 或 23.x 构建回退到：

• Oracle (21.14.0.0.0_240525)
• Big Data (21.14.0.0_0_240515)
• MySQL (21.14.0.0_240404)
• MSSQL (21.14.0.0.0_240404)

您可能会遇到以下问题之一：

• 由于新的 wallet 加密功能引入了 21.15 以后缺少连接/身份证明问题。

  解决方法：必须取消分配和重新分配到部署的现有连接，并重新创建任何正在使用的分发或接收器路径所需的缺少用户。

• 由于性能度量服务在 23.x 到 21.14 的回退中出现问题，服务管理器无法启动。如果您遇到此问题，请与 Oracle 技术支持联系。
• Oracle GoldenGate 进程失败，出现错误 “OGG-02431 在检查点文件中找到的记录标头无效”。

  解决方法：将部署升级到该系列中可用的最新 21.14 构建。如果问题仍然存在，请与 Oracle 技术支持联系。

---

标题和版权信息

Copyright ©2022,2025,

Oracle 和/或其关联公司。