PostgreSQL pg_waldump
pg_waldump — 以人类可读的形式显示一个PostgreSQL 数据库集簇的预写式日志
大纲
pg_waldump [option...] [startseg [endseg]]
简介
pg_waldump显示预写式日志（WAL），它主要 用于调试或者教育目的。
这个工具只能由安装该服务器的用户运行，因为它要求对数据目录的只读访问。
选项
下列命令行选项控制输出的位置和格式：
startseg-
从指定的日志段文件开始读取。这也隐含地决定了要搜索文件的路径以及 要使用的时间线。
endseg-
在读取指定的日志段文件后停止。
-b--bkp-details-
输出有关备份块的细节。
-eend--end=end-
在指定的WAL位置停止读取，而不是一直读取到日志流的末尾。
-f--follow-
在到达可用 WAL 的末尾之后，保持每秒轮询一次是否有新的 WAL 出现。
-nlimit--limit=limit-
显示指定数量的记录，然后停止。
-ppath--path=path-
指定搜索日志段文件的目录或包含这些文件的包含
pg_wal子目录的目录。 缺省值是在当前目录中搜索，当前目录的pg_wal子目录和PGDATA的pg_wal子目录。 -q--quiet-
除错误外，不要打印任何输出。当您想知道一系列WAL记录是否可以成功解析但不关心记录内容时，此选项非常有用。
-rrmgr--rmgr=rmgr-
只显示由指定资源管理器生成的记录。如果把
list作为资源管理器名称 传递给这个选项，则打印出可用资源管理器名称的列表然后退出。 -sstart--start=start-
要从哪个WAL位置开始读取。默认是从找到的最早的文件的第一个可用日志记录开始。
-ttimeline--timeline=timeline-
要从哪个时间线读取日志记录。默认是使用
startseg（如果指定） 中的值，否则默认为 1。 -V--version-
打印pg_waldump版本并且退出。
-xxid--xid=xid-
只显示用给定事务 ID 标记的记录。
-z--stats[=record]-
显示概括统计信息（记录的数量和尺寸以及全页镜像）而不是显示 每个记录。可以选择针对每个记录生成统计信息，而不是针对每个 资源管理器生成。
-?--help-
显示有关pg_waldump命令行参数的帮助并且退出。
Environment
PGDATA-
数据目录；另请参阅
-p选项。 PG_COLOR-
规定在诊断消息中是否使用颜色。可能的值为
always、auto、never。
注解
当服务器正在运行时可能会给出错误的结果。
只有指定的时间线 会被显示（如果没有指定，则显示默认时间线）。 其他时间线上的记录会被忽略。
pg_waldump不能读取具有后缀.partial
的 WAL 文件。如果需要读取那些文件，需要从文件名中移除 .partial后缀。