已知问题和解决方法

本章介绍了发布时的已知问题。

发行版 26ai (23.26.4) — 2026 年 10 月

错误 39752615:Exadata CS - 提取在具有 NOUSERID 的 DOWNSTREAM 配置中异常终止,在 BR 追补流中时

在具有 NOUSERID 追补 BR 评估流的下游提取中将异常终止提取。

解决方法

对于与追补 BR 流相关的问题的已确认发生情况,请使用提取中的以下参数禁用追补 BR 流并避免该问题。

BR _NOCATCHUPBR

错误 39908753:Google Spanner - Parallel Replicat RARE(1/20 次)NOT_FOUND 在将 SPLIT_TRANS_RECS 与具有 PK 更新功能的 BATCHSQL 结合使用时发现错误

在 BatchSQL USEMUTATIONS 模式下使用 SPLIT_TRANS_RECS 参数运行并行复制并且源线索经常更新主键时,复制可能会异常终止,出现 NOT_FOUND 错误。

解决方法

无。

错误 40178988:Google Spanner - Replicat 在应用超过 80,000 个突变的交易时失败

在 Spanner 数据库上应用具有超过 80,000 个突变的事务处理时,复制异常终止,但出现以下错误:

[SQL error 4] Permanent error, with a last message of Deadline expired before operation could complete.

解决方法

要避免此类故障,必须仔细选择防止热点的主要密钥。例如:

CREATE TABLE UserAccessLogs
(
  LastAccess TIMESTAMP NOT NULL,
  UserId STRING(1024),
  ...
) PRIMARY KEY (LastAccess, UserId);

有关详细信息,请参阅 https://docs.cloud.google.com/spanner/docs/schema-design#primary-key-prevent-hotspots

错误 40246963:MySQL- 使用大于或等于 9.5 且 MySQL Server >= 8.3 的 MySQL shell 版本

管理 MySQL InnoDB 集群时,可能会停止 Oracle GoldenGate 提取。

GoldenGate 当前支持标准 GTID,但不支持标记 GTID。当与 MySQL Server 8.3 或更高版本一起使用时,MySQL Shell 9.5 及更高版本会自动将 mysqlsh 标记添加到某些管理事务中。如果遇到这些事务处理,基于 GTID 的提取可能会失败。这会影响 MySQL InnoDB 集群的基于 GTID 的捕获。使用日志编号和偏移量的独立 MySQL 捕获不受影响。

要防止此问题,请在将 MySQL 群集升级到高于或等于 8.3 的版本之前执行操作。对于版本高于或等于 8.3 的新 MySQL 群集安装:

在使用基于 GoldenGate GTID 的提取时,不要将 MySQL Shell 9.5 或更高版本用于群集操作。如果在启动升级后选择 Shell 版本,则不会阻止提取失败。如果 MySQL Shell 9.5 或更高版本添加了标记的 GTID,则提取可能会失败,并且恢复需要完全重新同步。

解决方法

您仍可以将 MySQL Server 升级到版本 9.5 或更高版本。在配置 GoldenGate 提取之前,使用 MySQL Shell 9.4 或更低版本安装、配置或升级 InnoDB 集群。

撤消 TRANSACTION_GTID_TAG 权限不是有效的解决方法,可能会导致 MySQL Shell 操作(例如添加或删除实例)失败。

警告:MySQL Shell 9.4 包含后续发行版中解决的漏洞。在使用此临时解决方法之前,请先向您的安全团队复核安全影响。

发行版 26ai (23.26.2.0.3) — 2026 年 7 月

错误 38496203:自治 AI 数据库 - 复制异常终止,错误 ORA-04043 “对象不存在”在目标数据库中

GoldenGate 即使存在目标表,自治 AI 数据库上的复制也会异常终止,并使用 error ORA-04043 "object does not exist" 终止目标表。问题是由于较低高速缓存的自治 AI 数据库目标的字典和 DDL 通知不正确导致错误的对象未找到错误。

解决方法

在复制参数文件中添加 NOTARGETDDLNOTIFY 参数以在目标上禁用 DDL 通知。刷新共享池或将目标 ADB 移动到更高核心配置也可以允许字典正确加载。

发行版 26ai (23.26.2.0.0) — 2026 年 4 月

错误 39178714:PostgreSQL - 提取将 JSONB 数据类型写入为文本数据,而不是二进制,从而导致自动方案 TYPEMAP 行为不正确

将 Oracle GoldenGate 与 PostgreSQL 源结合使用时,线索中的 JSONB 数据类型将写入为文本数据,而不是二进制格式,因此线索中的 JSON 和 JSONB 数据类型之间没有差异。由于此行为,JSONB 的 AUTOSCHEMA TYPEMAP 映射无法按预期工作。

解决方法

要使用 AUTOSCHEMA TYPEMAP 将 JSONB 源列映射到其他目标数据类型,请将源类型指定为 JSON,而不是 JSONB。例如:

AUTOSCHEMAOPTIONS TYPEMAP 'json'='VARCHAR(200)'

错误 37575375:PostgreSQL - Test_decoding 插件不支持对多个表执行截断操作

由于当前解析逻辑的限制,PostgreSQL test_decoding 插件不支持对多个表执行截断操作。

发行版 26ai (23.26.1.0.6) — 2026 年 3 月

错误 38924691:Db2 z/OS - 提取异常终止,出现错误 OGG-01741 意外日志序列号

尽管在 Extract 从 Db2 z/OS 读取日志记录时,bug 修复了部分日志序列号不正常问题,但仍有一些边缘情况会触发此问题。

解决方法

虽然我们正在研究一个更全面的修复,但解决方法是重新启动提取,它将解决问题并继续运行。

发行版 26ai (23.26.1.0.5) — 2026 年 3 月

错误 31531059:MySQL - Windows - 从非 MySQL 部署安装 Service Manager 时,创建部署失败

在 Windows 中创建 MySQL 部署时,如果服务管理器是在非 MySQL 部署下创建的,则该服务管理器的后续 MySQL 部署将无法完成。

解决方法

如果为服务器上的不同数据库供应商创建 Oracle GoldenGate 的多个部署,而不仅仅是 MySQL 部署,则从 MySQL oggca 程序创建 Service Manager 部署。

发行版 26ai (23.26.1.0.3) — 2026 年 2 月

错误 38973035:通用 - 使用‘?通配符时,复制异常终止,错误为“Invalid TARGET Wildcard Table Name”

在 Windows 上使用问号“?”作为通配符时,复制会异常终止,并出现错误。

解决方法

在 Replicat 参数文件中列出全表名,而不是使用问号 (?) 通配符规范。

错误 38869812:通用 - 注册服务管理器具有不支持的 Windows 命令

将 Service Manager 注册为 Windows 服务时,registerServiceManager.bat 脚本可能会返回一条非关键消息,指出命令无法识别为内部或外部命令。

解决方法

您可以忽略非关键消息,并在部署完成时验证 Service Manager 是否存在并在 Windows 服务子视图中运行。此外,请验证是否可以登录到 Service Manager 和部署。

错误 38942442:通用 - 使用 WebUI 为线索配置子文件夹时提取异常终止

将子目录与线索文件一起使用时,在 Windows 上提取和复制异常终止。自动生成的参数文件使用不正确的正斜杠 (/) 而不是路径分隔符的反斜杠 () 创建。

解决方法

创建参数文件后手动编辑该文件,将路径分隔符从正斜杠 (/) 更改为反斜杠 ()(例如 subdir\ex),然后重新启动该过程。

错误 38270083:通用 - 没有 Visual C++ Redistributable v14,Oracle GoldenGate OUI 安装程序不会在 Windows 上启动

如果未在 Windows 服务器上安装 Microsoft Visual C++ Redistributable v14 软件包,则 Oracle GoldenGate OUI 安装程序将不会启动。

解决方法

要在 Windows 上安装 Oracle GoldenGate,请安装最新的 Microsoft Visual C++ Redistributable v14 软件包,网址为 https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-supported-redistributable-version

发行版 26ai (23.26.1.0.1) — 2026 年 2 月

错误 38910133:一般 - 创建表后无法修改“仅心跳表目标”设置

当您尝试使用“仅目标”设置修改心跳表时,该设置在配置后将无法更新。支持“仅目标心跳”表的非 Oracle 数据库上存在此问题。

解决方法

要使用所需值配置“仅目标”设置,请删除现有心跳表并添加具有所需值的新表。

错误 38828193:“管理服务”页上的“通用 - 左侧”导航菜单不会自动显示第一个添加的提取或复制

使用 Web 界面添加第一个“提取”或“复制”时,“管理服务”页的左侧导航菜单不会自动显示它们,但是随后添加的“提取”或“复制”将自动显示在菜单上。

解决方法

添加第一个提取或复制后,必须刷新一次页面。

错误 38963914:MySQL - 无法通过 Web 界面将提取更改为指定的 LOGNUM 和 LOGPOS

将提取从 Web 界面更改为指定的 LOGNUM 和 LOGPOS 会生成 Begin Now。

解决方法

使用管理客户机命令行实用程序更改提取以定位 LOGNUM 和 LOGPOS。

错误 38964868:MySQL - 通过 Web 界面创建提取时“日志中的位置”字段重复

使用 Web 界面创建提取并在 Begin 字段中选择 LSN 时,Log Number 和 Log Bin 字段都错误地标记为“日志中的位置”。

解决方法

从左到右,第一个字段表示 LOGNUM 值,第二个字段表示 LOGPOS 值,尽管有其标签,也会以这种方式实现。或者,可以使用 ADD EXTRACT 通过管理客户端创建提取。

错误 37098868:Teradata/Timesten - 心跳功能在 Web 界面上无法正常工作

尝试从 Oracle GoldenGate for Teradata 和 Timesten Web 界面管理心跳时,心跳功能无法正常工作。

解决方法

要管理心跳,请使用管理客户机中的 ADD HEARTBEATTABLE 或 DELETE HEARTBEATTABLE 命令。

发行版 26ai (23.26.1.0.0) — 2026 年 3 月

错误 39081675:通用 - 在从发行版 23.10.0.0 更新到 23.26.1.0 的补丁程序后清除线索任务失败,导致磁盘空间问题

修补程序更新到版本 23.26.1.0 后清除线索任务失败,导致空间问题。

解决方法

检查检查点后手动删除线索文件。

错误 38974142:通用 - 更改复制时“线索”字段中的位置不可编辑

在 Web 界面上更改复制时,“线索中的位置”字段不可编辑。

解决方法

使用 Admin Client 命令行实用程序运行 ALTER REPLICAT 命令。

发行版 23.10.3.25.11- 2025 年 12 月

错误 38526643:SQL Server - 提取异常终止,COLMAP 子句中出现错误

在提取中使用 COLMAP 子句执行目标列映射时,SQL Server 提取会显示错误。

解决方法

使用复制中的 COLMAP 子句而不是提取将源列重新映射到不同的目标列。

发行版 23.10.1.25.10- 2025 年 10 月

错误 37859560:PostgreSQL - 初始加载提取 ExtFile 名称需要 3 个字符,而不是两个

在创建初始加载提取时,Oracle GoldenGate 要求使用 3 个字符作为文件名,而不是标准两个字符。

解决方法

提供 3 个字符以绕过步骤,然后在下一步的参数文件中手动更改步骤。

发行版 23.10.0.25.10- 2025 年 10 月

错误 38544821:通用 - 在交互模式 (OUI) 中将服务管理器注册为服务/守护进程引发错误 - ‘无法停止部署’

首次运行 OGGCA 以创建第一个部署并将服务管理器设置为作为服务或系统守护进程运行时,创建部署可能会返回多个错误。

解决方法

为避免此问题,同时仍可以应用 Oracle GoldenGate 23.10.x 补丁程序:

  1. 安装 23.10.x 之前的 Oracle GoldenGate 版本。

  2. 使用该早期版本的 Oracle GoldenGate 将服务管理器创建为服务/守护进程。

  3. 使用 OPatch 应用 Oracle GoldenGate 23.10.x 补丁程序构建。

发行版 23.9- 2025 年 7 月

错误 37873099:Db2 z/OS - 无法添加或删除检查点表

如果检查点事务表被错误地清除,则检查点表可能会被删除,但事务表会保留。再次添加此检查点表时,将无法添加事务处理表,因为它已存在。

解决方法

再次删除检查点表。如果这不起作用,则尝试手动删除事务处理表,该表将与检查点表位于同一方案中,并且名称与附加了 _lox 的事务处理表相同。

错误 37710172:Db2 z/OS- 如果库未获得授权,则版本返回为 0

如果 WLM steplibs 库未获得授权,则提取将异常终止,因为版本号为 0。

解决方法

确保磁带库已获得授权。

发行版 23.8-2025 年 4 月

错误 37834526:SQL Server - 在 CDC 和基表不匹配时提取异常终止

提取将基表的表结构与 CDC 捕获实例表进行比较,在不匹配时导致异常终止。

解决方法

将以下内容添加到提取参数文件并重新启动它:

TRANLOGOPTIONS GETMETADATAFROMVAM

发行版 23.6- 2024 年 10 月

错误 37152943:i 的 Db2 - 提取失败,心跳表存在核心转储问题

对于 Oracle GoldenGate Extract for Db2 for i,异常终止并返回心跳表的核心转储错误。这会导致心跳功能无法工作。

解决方法

无。

错误 37468391:Oracle - XAGTask 在停止一个服务管理器时将终止节点上运行的所有 GoldenGate 进程

当使用多个 OGG_HOME 目录运行 Oracle GoldenGate,并且注册到 XAG 的服务管理器失败或被 XAG/CRS 停止时,服务器上运行的所有 GoldenGate 进程都将停止,无论 OGG_HOME 的运行时间是多少。这将导致服务器范围的 GoldenGate 停机。

解决方法

在具有以下功能的服务器上仅使用 XAG 与 Oracle GoldenGate 的集成:

发行版 23.5- 2024 年 8 月

Sybase 不支持并行复制

Oracle GoldenGate for Sybase 不支持并行复制。

解决方法

使用协调复制或经典复制。

错误 36926498:Sybase - Bi-directional Extract 崩溃而没有任何错误

配置为双向复制的提取出现问题会导致提取异常终止。

解决方法:

无

错误 36927786:通用 - OGGCA 部署创建未选取 SYBASE 系统变量/值

创建 Sybase 部署时,不会自动为部署设置 SYBASE 系统变量。

解决方法

手动将 SYBASE 变量添加到部署的环境变量配置中,然后设置 Sybase 主目录的路径(例如 /opt/sap),然后重新启动部署。

发行版 23.4- 2024 年 5 月

显式排除反向文件 (Inverted File,IVF) 和分层可导航小世界 (Hierarchical Navigable Small World,HNSW) 索引表

如果使用通配符参数,则必须从提取中显式排除 IVF 和 HSNW 向量索引表。

解决方法

无

提取 LSN 定位对管理客户端的 0x:8:8:4 格式不起作用

对于 SQL Server,使用管理客户机启动 ATCSN 或 AFTERCSN 的提取并使用 0x8:8:4 格式的 LSN 值无法按预期工作。

解决方法

请按以下格式提供 LSN 值:0x8:8:4-ffffffff-8:8:4。

例如:

START EXTRACT EXTPROD AFTERCSN 0x000000b3:00002240:0003-ffffffff-000000b3:00002240:0003