DuebassLei
Search K

Appearance

📘 Oracle GoldenGate 运维常用命令宝典 ​

以下是 OGG（Oracle GoldenGate）运维常用命令宝典，适用于日常监控、管理、排错等场景，按功能分类整理，简洁实用 👇

💡 前提：已进入 GGSCI（GoldenGate Software Command Interface）
启动方式：./ggsci

🔹 1. 查看状态 ​

bash
-- 查看所有进程状态
INFO ALL

-- 查看具体进程（如抽取进程 ext1）
INFO EXTRACT ext1

-- 查看详细状态（含延迟、检查点）
INFO EXTRACT ext1, DETAIL

-- 查看历史运行状态
STATS EXTRACT ext1, TOTAL

🔹 2. 启动 / 停止进程 ​

bash
-- 启动抽取进程
START EXTRACT ext1

-- 启动投递进程
START EXTRACT dpmp1

-- 启动复制进程
START REPLICAT rep1

-- 停止进程（优雅停止）
STOP EXTRACT ext1

-- 强制停止（慎用）
KILL EXTRACT ext1

⚠️ 注意：先停 Replicat，再停 Extract；启动顺序相反。

🔹 3. 查看延迟与检查点 ​

bash
-- 查看延迟（关键指标！）
LAG EXTRACT ext1
LAG REPLICAT rep1

-- 查看检查点信息（用于断点续传）
INFO EXTRACT ext1, SHOWCH
  • 理想延迟：< 5 秒
  • 延迟高？ 检查网络、目标库性能、长事务

🔹 4. 日志与错误排查 ​

bash
-- 查看进程日志（自动打开）
VIEW REPORT ext1

-- 实时跟踪日志（类似 tail -f）
SHOW OUTPUT

-- 查看 discard 文件（被过滤/报错的数据）
-- 路径：dirrpt/rep1.dsc

💡 错误常见原因：

  • 表结构不一致
  • 主键缺失
  • 目标库空间不足
  • 数据类型不兼容

🔹 5. 注册与数据库交互（Oracle） ​

bash
-- 注册 Extract 到数据库（启用 DDL 支持）
REGISTER EXTRACT ext1 DATABASE

-- 查看注册状态
DBLOGIN USERID ogguser@orcl, PASSWORD xxx
INFO EXTRACT ext1, SHOWCH

-- 添加表级补充日志（关键！）
ADD TRANDATA scott.emp

✅ 必须为同步的表开启 TRANDATA，否则 UPDATE/DELETE 无法捕获完整前像！

🔹 6. 配置管理 ​

bash
-- 编辑参数文件
EDIT PARAMS ext1

-- 查看当前参数
VIEW PARAMS ext1

-- 重新加载参数（无需重启）
ALTER EXTRACT ext1, PARAMS

-- 删除进程（先 STOP）
DELETE EXTRACT ext1

🔹 7. 心跳表监控（可选高级功能） ​

bash
-- 创建心跳表（监控端到端延迟）
SEND EXTRACT ext1, HEARTBEAT TABLE ogg.heartbeat

-- 查看心跳延迟
LAG HEARTBEAT

🔹 8. 清理过期文件（防磁盘爆满） ​

bash
-- 自动清理 trail 文件（建议配置 mgr.prm）
PURGEOLDEXTRACTS ./dirdat/*, USECHECKPOINTS, MINKEEPHOURS 2

-- 手动清理（谨慎！）
-- 删除 dirrpt/ 下旧报告
-- 删除 dirdat/ 下已消费的 trail 文件（通过 USECHECKPOINTS 判断）

🔹 9. 常用 MGR（Manager）命令 ​

bash
-- 查看 Manager 状态
INFO MANAGER

-- 启动/停止 Manager
START MANAGER
STOP MANAGER

⚠️ Manager 是 OGG 的“总控”，必须保持运行！

🔹 10. 快速诊断 checklist ​

问题命令
进程是否运行？INFO ALL
有无延迟？LAG EXTRACT ext1
为什么停止？VIEW REPORT ext1
补充日志开了吗？INFO TRANDATA scott.emp
Trail 文件堆积？ls -lh dirdat/ + PURGEOLDEXTRACTS

✅ 黄金建议：

  1. 每天巡检：INFO ALL + LAG
  2. 保留最近3天日志
  3. 关键表务必 ADD TRANDATA
  4. 不要手动删除 trail 文件！

📌 保存路径建议：
将本手册存为 ogg_cheatsheet.txt 放在 $OGG_HOME 目录下，随用随查！