pg_waldump
pg_waldump — 以人类可读形式显示 PostgreSQL 数据库集簇的预写式日志
大纲
pg_waldump [option...] [startseg [endseg]]
描述
pg_waldump 显示预写式日志(WAL),主要用于调试或教学。
该工具只能由安装服务器的用户运行,因为它要求对数据目录具有只读访问权限。
选项
以下命令行选项控制输出的位置和格式:
startseg从指定的 WAL 段文件开始读取。这会隐式决定搜索文件时所使用的路径以及要使用的时间线。
endseg读取完指定的 WAL 段文件后停止。
-b--bkp-details输出有关备份块的详细信息。
-eend--end=end在指定的 WAL 位置停止读取,而不是一直读取到日志流末尾。
-f--follow在到达有效 WAL 的末尾后,继续每秒轮询一次,等待新的 WAL 出现。
-nlimit--limit=limit显示指定数量的记录,然后停止。
-ppath--path=path指定一个用于搜索 WAL 段文件的目录,或者指定一个包含
pg_wal子目录且其中包含此类文件的目录。默认会在当前目录、当前目录的pg_wal子目录以及PGDATA的pg_wal子目录中搜索。-rrmgr--rmgr=rmgr仅显示由指定资源管理器生成的记录。如果传入的名称为
list,则打印有效资源管理器名称的列表并退出。-sstart--start=start从指定的 WAL 位置开始读取。默认会从找到的最早文件中的第一条有效 WAL 记录开始读取。
-ttimeline--timeline=timeline读取日志记录时所使用的时间线。如果指定了
startseg,默认使用其中的值;否则默认值为 1。-V--version打印 pg_waldump 的版本并退出。
-xxid--xid=xid仅显示标记有给定事务 ID 的记录。
-z--stats[=record]显示汇总统计信息(记录和整页镜像的数量及大小),而不是单条记录。也可以选择按记录类型而不是按资源管理器生成统计信息。
-?--help显示 pg_waldump 命令行参数的帮助信息,并退出。
环境
PGDATA数据目录;另请参阅
-p选项。PG_COLOR指定诊断消息是否使用颜色。可选值为
always、auto和never。
注解
服务器运行时,可能给出错误的结果。
只显示指定的时间线(如果未指定,则使用默认时间线)。其他时间线中的记录会被忽略。
pg_waldump 不能读取带有.partial 后缀的
WAL 文件。如果需要读取这些文件,则必须从文件名中移除.partial
后缀。