pg_waldump

pg_waldump —显示 PostgreSQL 数据库集群的预写日志的可读格式

Synopsis

pg_waldump [ option ...] [ startseg [ endseg ] ]

Description

pg_waldump显示预写日志(WAL)，主要用于调试或教学目的。

该 Util 只能由安装服务器的用户运行，因为它需要对数据目录的只读访问。

Options

以下命令行选项控制输出的位置和格式：

• startseg

  • 从指定的日志段文件开始读取。这隐式确定了将在其中搜索文件的路径以及要使用的时间轴。

• endseg

  • 读取指定的日志段文件后停止。

• -b
--bkp-details

  • 输出有关备份块的详细信息。

• -e end
--end=end

  • 在指定的 WAL 位置停止读取，而不是读取到日志流的末尾。

• -f
--follow

  • 到达有效 WAL 的结尾后，continue 每秒轮询一次，以显示新的 WAL。

• -n limit
--limit=limit

  • 显示指定的记录数，然后停止。

• -p path
--path=path

  • 指定用于搜索日志段文件的目录或具有包含此类文件的pg_wal子目录的目录。默认设置是在当前目录，当前目录的pg_wal子目录和PGDATA的pg_wal子目录中搜索。

• -r rmgr
--rmgr=rmgr

  • 仅显示由指定资源 Management 器生成的记录。如果将list作为名称传递，则打印有效资源 Management 器名称的列表，然后退出。

• -s start
--start=start

  • 开始阅读的 WAL 位置。默认设置是开始读取最早找到的文件中找到的第一个有效日志记录。

• -t timeline
--timeline=timeline

  • 从中读取日志记录的时间轴。如果指定了默认值，则使用* startseg *中的值；否则，默认值为 1.

• -V
--version

  • 打印 pg_waldump 版本并退出。

• -x xid
--xid=xid

  • 仅显示标记有给定 TransactionID 的记录。

• -z
--stats[=record]

  • 显示摘要统计信息(记录和整页图像的数量和大小)，而不是单个记录。 (可选)按记录而不是按 rmgr 生成统计信息。

• -?
--help

  • 显示有关 pg_waldump 命令行参数的帮助，然后退出。

Notes

服务器运行时可能给出错误的结果。

仅显示指定的时间轴(如果未指定，则为默认)。其他时间轴中的记录将被忽略。

pg_waldump 无法读取后缀为.partial的 WAL 文件。如果需要读取这些文件，则需要从文件名中删除.partial后缀。

See Also

Section 30.5