Oracle GoldenGate 经典架构日常运维与故障排查 100 条命令

Oracle GoldenGate 经典架构日常运维与故障排查 100 条命令（建议收藏）

前言

GoldenGate 经典架构常用于数据库迁移和实时数据同步。Extract 从源库捕获数据变化，Data Pump 负责远端传输，Replicat 在目标库应用；Trail 文件和检查点记录了复制链路的处理位置。

Oracle GoldenGate 经典架构示意图 Oracle GoldenGate 经典架构示意图

进程 ABEND 或复制延迟时，除了看运行状态，还要对照 Extract、Pump、Replicat 的 Trail 位点、检查点和报告文件。长事务、目标库报错、网络中断，处理方法各不相同。

本文整理了经典架构日常检查、延迟排查和故障处理常用的 100 条命令，内容较多，建议收藏备用。

文中以 Linux 环境下的 GGSCI 为例，进程名、Trail 前缀、数据库账号及复制对象请根据实际环境修改。

一、环境、版本与全局状态

1. 进入 GoldenGate 命令行

Bash

1$OGG_HOME/ggsci

2. 查看 GoldenGate 及运行环境版本

1VERSIONS

3. 查看 GGSCI 当前环境

1SHOW

4. 查看最近执行过的命令

1HISTORY

5. 列出全部进程状态

1INFO ALL

先用它找出 STOPPED 或 ABEND 的进程，再对异常进程执行 INFO ... DETAIL。

6. 列出 Extract 和 Replicat 状态

1INFO ER *

7. 查看 Manager 状态

1INFO MANAGER

8. 检查 Manager 是否运行

1STATUS MANAGER

9. 查看 GoldenGate 事件日志

1VIEW GGSEVT

10. 查看指定命令的帮助

1HELP INFO EXTRACT

二、Manager 与端口管理

11. 查看 Manager 参数文件

1VIEW PARAMS MGR

12. 编辑 Manager 参数文件

1-- 修改前备份 dirprm/mgr.prm
2EDIT PARAMS MGR

13. 向 Manager 请求运行状态

1SEND MANAGER STATUS

14. 查看 Manager 管理的进程

1SEND MANAGER GETPORTINFO DETAIL

输出里能看到 Manager 给各进程分配的端口，排查防火墙或端口冲突时很有用。

15. 查看 Manager 使用的动态端口

1SEND MANAGER GETPORTINFO

16. 检查 Manager 报告文件

1VIEW REPORT MGR

17. 读取 Manager 错误日志末尾

Bash

1tail -n 100 $OGG_HOME/dirrpt/MGR.rpt

18. 检查 Manager 监听端口

Bash

1ss -lntp | grep mgr

19. 检查 GoldenGate 进程与启动路径

Bash

1ps -ef | grep '[m]gr\|[e]xtract\|[r]eplicat'

20. 检查 GoldenGate 目录空间

Bash

1du -sh $OGG_HOME/dir*
2df -h $OGG_HOME

三、Extract 捕获进程

21. 查看 Extract 基本状态

1INFO EXTRACT ext1

22. 查看 Extract 详细状态

1INFO EXTRACT ext1, DETAIL

DETAIL 会列出参数文件、Trail 和检查点。进程显示 RUNNING 但数据不走时，先看这里的位置有没有变化。

23. 查看 Extract 全部检查点

1INFO EXTRACT ext1, SHOWCH

SHOWCH 展开的检查点较多，排障时主要关注当前读取和写入的 Trail 序号、RBA。

24. 查看 Extract 任务信息

1INFO EXTRACT ext1, TASKS

25. 查看 Extract 当前状态

1STATUS EXTRACT ext1

26. 查看 Extract 延迟

1LAG EXTRACT ext1

LAG 是上一次计算值。怀疑数值过期时先执行 SEND EXTRACT ext1, GETLAG。

27. 查看 Extract 累计统计

1STATS EXTRACT ext1, TOTAL

28. 查看 Extract 最近一小时统计

1STATS EXTRACT ext1, HOURLY

29. 查看 Extract 最近一次启动后的统计

1STATS EXTRACT ext1, RESET

RESET 不是清空统计，而是统计“本次进程启动以来”的数据量。

30. 查看 Extract 当前读取位置

1SEND EXTRACT ext1, STATUS

四、Data Pump 传输进程

31. 查看 Pump 基本状态

1INFO EXTRACT pmp1

32. 查看 Pump 详细状态

1INFO EXTRACT pmp1, DETAIL

33. 查看 Pump 全部检查点

1INFO EXTRACT pmp1, SHOWCH

34. 查看 Pump 当前状态

1STATUS EXTRACT pmp1

35. 查看 Pump 延迟

1LAG EXTRACT pmp1

36. 查看 Pump 累计统计

1STATS EXTRACT pmp1, TOTAL

37. 查看 Pump 最近一小时统计

1STATS EXTRACT pmp1, HOURLY

38. 查看 Pump 连接状态

1SEND EXTRACT pmp1, STATUS

Pump 与远端断开时，这里通常能看到连接状态；随后再查目标 Manager 和网络。

39. 查看 Pump 打开的文件

1SEND EXTRACT pmp1, SHOWTRANS

SHOWTRANS 看的是当前开放事务。事务持续时间长不一定异常，要结合源库事务确认。

40. 查看 Pump 报告文件

1VIEW REPORT pmp1

五、Replicat 应用进程

41. 查看 Replicat 基本状态

1INFO REPLICAT rep1

42. 查看 Replicat 详细状态

1INFO REPLICAT rep1, DETAIL

43. 查看 Replicat 全部检查点

1INFO REPLICAT rep1, SHOWCH

Replicat 的读取检查点长期不动，才说明应用可能停住；只看进程为 RUNNING 不够。

44. 查看 Replicat 任务信息

1INFO REPLICAT rep1, TASKS

45. 查看 Replicat 当前状态

1STATUS REPLICAT rep1

46. 查看 Replicat 延迟

1LAG REPLICAT rep1

47. 查看 Replicat 累计统计

1STATS REPLICAT rep1, TOTAL

48. 查看 Replicat 最近一小时统计

1STATS REPLICAT rep1, HOURLY

49. 查看 Replicat 最近一次启动后的统计

1STATS REPLICAT rep1, RESET

这里的统计从 Replicat 最近一次启动算起，重启前后的数字不能直接相减。

50. 查看 Replicat 当前应用状态

1SEND REPLICAT rep1, STATUS

六、Trail、检查点与事务

51. 查看 Extract 对应的 Trail

1INFO EXTRACT ext1, DETAIL

52. 查看 Pump 对应的远端 Trail

1INFO EXTRACT pmp1, DETAIL

53. 查看 Replicat 读取的 Trail

1INFO REPLICAT rep1, DETAIL

54. 列出本地 Trail 文件

Bash

1ls -lh $OGG_HOME/dirdat/aa*

同一前缀可能有多代 Trail。文件还在增长，只能说明上游仍在写，不能说明 Replicat 已经追上。

55. 按时间查看最新 Trail

Bash

1ls -lht $OGG_HOME/dirdat | head -20

56. 查看 Trail 目录占用

Bash

1du -sh $OGG_HOME/dirdat
2df -h $OGG_HOME/dirdat

57. 查看 Extract 的开放事务

1SEND EXTRACT ext1, SHOWTRANS

58. 查看超过十分钟的开放事务

1SEND EXTRACT ext1, SHOWTRANS DURATION 10 MIN

长事务会阻止 Extract 推进检查点。确认事务来源后，再决定等待、提交还是回滚。

59. 查看 Replicat 的开放事务

1SEND REPLICAT rep1, SHOWTRANS

60. 查看检查点表配置

1INFO CHECKPOINTTABLE

检查点表用于保存 Replicat 位置。目标库迁移或重建前，别漏掉这张表。

七、延迟、吞吐与心跳

61. 查看所有进程延迟

1LAG ER *

62. 查看所有 Extract 延迟

1LAG EXTRACT *

63. 查看所有 Replicat 延迟

1LAG REPLICAT *

64. 请求 Extract 立即生成延迟记录

1SEND EXTRACT ext1, GETLAG

GETLAG 会让进程重新计算延迟，随后再执行 LAG EXTRACT 查看新值。

65. 请求 Pump 立即生成延迟记录

1SEND EXTRACT pmp1, GETLAG

66. 请求 Replicat 立即生成延迟记录

1SEND REPLICAT rep1, GETLAG

67. 查看 Extract 每日统计

1STATS EXTRACT ext1, DAILY

68. 查看 Replicat 每日统计

1STATS REPLICAT rep1, DAILY

69. 查看指定表的 Extract 统计

1STATS EXTRACT ext1, TABLE app.orders, TOTAL

表级统计适合确认某张表有没有捕获到数据。结果为 0 时，再核对 TABLE/MAP 规则和过滤条件。

70. 查看指定表的 Replicat 统计

1STATS REPLICAT rep1, TABLE app.orders, TOTAL

八、参数、报告与异常日志

71. 查看 Extract 参数

1VIEW PARAMS ext1

72. 查看 Pump 参数

1VIEW PARAMS pmp1

73. 查看 Replicat 参数

1VIEW PARAMS rep1

74. 检查 Extract 参数语法

Bash

1$OGG_HOME/checkprm ./dirprm/ext1.prm

checkprm 只检查参数语法和部分语义，不会验证数据库账号、表名和网络是否可用。

75. 检查 Pump 参数语法

Bash

1$OGG_HOME/checkprm ./dirprm/pmp1.prm

76. 检查 Replicat 参数语法

Bash

1$OGG_HOME/checkprm ./dirprm/rep1.prm

77. 查看 Extract 报告

1VIEW REPORT ext1

ABEND 时从报告中第一条 OGG 错误开始看，后面的重复报错常常只是连带结果。

78. 查看 Replicat 报告

1VIEW REPORT rep1

79. 查看 Extract 丢弃文件

1VIEW DISCARD ext1

Discard 文件里保存被丢弃记录及原因。文件为空不代表没有错误，还要看参数是否启用了 discard。

80. 搜索近期错误与告警

Bash

1grep -Ei 'OGG-|ERROR|WARNING|ABEND' $OGG_HOME/ggserr.log | tail -100

九、数据库登录与复制对象

81. 使用凭据别名登录数据库

1DBLOGIN USERIDALIAS oggadmin

82. 查看表的补充日志配置

1INFO TRANDATA app.orders

INFO TRANDATA 用来确认表级补充日志。更新主键或唯一键的表尤其要检查。

83. 查看 Schema 级补充日志配置

1INFO SCHEMATRANDATA app

84. 列出当前用户可见的表

1LIST TABLES app.*

85. 查看 Extract 注册信息

1INFO EXTRACT ext1, DETAIL

86. 检查 Oracle 数据库归档模式

Bash

1sqlplus -s / as sysdba <<'SQL'
2SET PAGES 100 LINES 200
3SELECT log_mode, force_logging FROM v$database;
4SQL

87. 检查数据库最小补充日志

Bash

1sqlplus -s / as sysdba <<'SQL'
2SET PAGES 100 LINES 200
3SELECT supplemental_log_data_min FROM v$database;
4SQL

88. 检查 GoldenGate 管理用户状态

Bash

1sqlplus -s / as sysdba <<'SQL'
2SET PAGES 100 LINES 200
3SELECT username, account_status FROM dba_users WHERE username='OGGADMIN';
4SQL

89. 检查指定 Replicat 检查点表

Bash

1sqlplus -s / as sysdba <<'SQL'
2SET PAGES 100 LINES 200
3SELECT owner, table_name FROM dba_tables WHERE owner='GGADMIN' AND table_name='GGS_CHECKPOINT';
4SQL

这里核对的是 Replicat 实际使用的检查点表，不要只看表是否存在。

90. 检查 GoldenGate 相关数据库会话

Bash

1sqlplus -s / as sysdba <<'SQL'
2SET PAGES 100 LINES 220
3SELECT sid, serial#, username, program, status FROM v$session WHERE upper(program) LIKE '%EXTRACT%' OR upper(program) LIKE '%REPLICAT%';
4SQL

十、启停与故障处置

91. 启动 Manager

1-- ogg 软件属主；确认 PORT 未被占用
2START MANAGER

92. 启动 Extract

1-- 确认数据库、凭据和 Trail 可用
2START EXTRACT ext1

93. 启动 Pump

1-- 确认目标 Manager 和网络可用
2START EXTRACT pmp1

94. 启动 Replicat

1-- 确认目标库和检查点表可用
2START REPLICAT rep1

95. 平滑停止 Extract

1-- 维护窗口；停止后确认检查点不再推进
2STOP EXTRACT ext1

96. 平滑停止 Replicat

1-- 维护窗口；先评估待应用数据量
2STOP REPLICAT rep1

97. 强制终止 ABEND 后无法停止的 Extract

1-- 最后手段；先保存报告、事件日志和检查点信息
2KILL EXTRACT ext1

KILL 不走正常停止流程，只在进程无法停止且现场信息已经保存时使用。

98. 跳过 Replicat 当前事务

1-- 高风险：会造成数据缺口；须有业务确认和补数方案
2START REPLICAT rep1, SKIPTRANSACTION

跳过事务会造成目标端少数据。执行前记下事务信息，并准备业务核对和补数。

99. 按 Trail 序号和 RBA 调整 Replicat

1-- 高风险：先停进程并记录原检查点；seqno、rba 按现场填写
2ALTER REPLICAT rep1, EXTSEQNO seqno, EXTRBA rba

修改 SEQNO 和 RBA 前先保存原检查点。位置填错可能导致重复应用或数据缺口。

100. 生成诊断信息后重启异常进程

1-- 先查明 ABEND 原因；不要循环盲目重启
2VIEW REPORT rep1
3VIEW GGSEVT
4START REPLICAT rep1

总结

处理 ABEND 时，先从报告中找第一条错误，再核对进程停在哪个 Trail 位点。跳事务和修改 Replicat 位点可能造成数据缺口或重复应用，动手前要保存原检查点并明确补数方案。

经典架构之外的 GoldenGate 和数据库命令，也放在 ORA100 · DBA100：

https://ora100.com/dba100

微信端可搜索小程序 「三笠的百令册」。