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子目录和PGDATApg_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