pg_waldump

解析 PostgreSQL WAL 日志

补充说明

pg_waldump 读取 WAL 段文件，打印记录类型、事务和资源信息，用于排查恢复、复制和崩溃问题。它是只读工具，不连接数据库。

常用示例

pg_waldump 000000010000000000000001
pg_waldump -p /var/lib/pgsql/data/pg_wal 000000010000000000000001
pg_waldump --start=0/16B4A60 --end=0/16B4B00 000000010000000000000001
pg_waldump -r XLOG 000000010000000000000001
pg_waldump -b 000000010000000000000001
pg_waldump --statistics 000000010000000000000001
pg_waldump -f 000000010000000000000001

易错点与排错

• WAL 文件名包含时间线、逻辑段和段号；拿错文件会解析失败。
• 需要与集群的系统标识和时间线匹配；跨集群的 WAL 不能混读。
• 在线实例的 WAL 可以读，但正在写入的段可能只解析到当前末尾。
• 输出量很大；先用 --start/--end 或 -r 过滤资源管理器。
• pg_waldump 不显示 SQL 语句；行级变更需要结合 --bkp-details 或逻辑解码。
• 解析失败可能是 WAL 损坏、版本不匹配或被压缩/归档工具改写。
• 只用于诊断；不要用它修改或截断 WAL。

相关命令

• pg_rewind — 修复分叉的备库
• pg_basebackup — 物理备份
• psql — 查询 pg_walfile_name 等函数