目录标题
- 一句话结论
- 背景：为什么改名？
- 具体对比
- 1️⃣ pg_xlogdump（已废弃）
- 2️⃣ pg_waldump（当前标准）
- 功能层面有没有区别？
- 运维视角（结合你最近在看的 WAL / 复制槽问题）
- 总结表
在 PostgreSQL 里，pg_waldump和pg_xlogdump本质上是同一个工具的不同时代名字，区别主要在版本和命名演进，而不是功能层面。
一句话结论
pg_xlogdump：旧名字（PostgreSQL ≤ 9.6）pg_waldump：新名字（PostgreSQL ≥ 10）- 功能基本一致，都是用来解析和查看 WAL（Write-Ahead Log）内容
背景：为什么改名？
从PostgreSQL 10 开始，官方做了一次非常重要的术语统一：
| 旧名称 | 新名称 |
|---|---|
xlog | wal |
pg_xlog目录 | pg_wal |
pg_xlogdump | pg_waldump |
XLOG_* | WAL_* |
目的：
👉让概念更清晰，避免 “xlog / wal 混用” 给运维和新手带来理解成本。
具体对比
1️⃣ pg_xlogdump（已废弃）
- 适用版本：PostgreSQL 9.6 及以前
- 解析对象：
pg_xlog/目录下的 WAL 文件 - 命令示例：
pg_xlogdump 00000001000000000000000A⚠️ PostgreSQL 10+不再提供该命令
2️⃣ pg_waldump（当前标准）
- 适用版本：PostgreSQL 10 及以后
- 解析对象：
pg_wal/目录下的 WAL 文件 - 命令示例：
pg_waldump pg_wal/00000001000000000000000A- 支持更完善的过滤参数：
pg_waldump\--rmgr=Heap\--limit=20\--start=0/16B6C50\pg_wal/00000001000000000000000A功能层面有没有区别？
👉几乎没有本质区别
二者都能：
查看 WAL record 类型（INSERT / UPDATE / COMMIT / CHECKPOINT）
分析复制延迟、WAL 堆积
排查：
- replication slot 导致 WAL 无法回收
- 备库 / logical decoding 卡住
- 异常 checkpoint / 大事务
PostgreSQL 10+ 的pg_waldump只是：
- 命名更规范
- 输出字段略有增强
- 与新 rmgr / WAL record 类型保持一致
运维视角（结合你最近在看的 WAL / 复制槽问题）
你之前在关注复制槽 + WAL 堆积 + max_slot_wal_keep_size，这里给你一个典型用法场景：
# 看某个 WAL 里是不是一直在产生大量 heap recordpg_waldump --rmgr=Heap --limit=50pg_wal/0000000100000000000000AF或者定位某个 LSN 附近发生了什么：
pg_waldump --start=0/2A000000 --end=0/2A010000 pg_wal/0000000100000000000000AF这在分析：
- 逻辑复制 slot 阻塞
- 订阅端长期不消费
- WAL 无法回收
时非常有价值。
总结表
| 项目 | pg_xlogdump | pg_waldump |
|---|---|---|
| PostgreSQL 版本 | ≤ 9.6 | ≥ 10 |
| 是否还维护 | ❌ 否 | ✅ 是 |
| WAL 目录 | pg_xlog | pg_wal |
| 功能 | 解析 WAL | 解析 WAL |
| 推荐使用 | ❌ | ✅ |
