pg_xlogdump
名称
pg_xlogdump -- 以人类可读的形式显示一个
PostgreSQL
数据库集簇的预写式日志
大纲
pg_xlogdump [option...] [startseg
[endseg]
]
简介
pg_xlogdump显示预写式日志(WAL),它主要
用于调试或者教育目的。
这个工具只能由安装该服务器的用户运行,因为它要求对数据目录的只读访问。
选项
下列命令行选项控制输出的位置和格式:
- startseg
从指定的日志段文件开始读取。这也隐含地决定了要搜索文件的路径以及
要使用的时间线。
- endseg
在读取指定的日志段文件后停止。
- -b
--bkp-details 输出有关备份块的细节。
- -e end
--end=end 在指定的日志位置停止读取,而不是一直读取到日志流的末尾。
- -f
--follow 在到达可用 WAL 的末尾之后,保持每秒轮询一次是否有新的 WAL 出现。
- -n limit
--limit=limit 显示指定数量的记录,然后停止。
- -p path
--path=path 要在哪个目录中寻找日志段文件。默认是在当前目录的pg_xlog
子目录中搜索。
- -r rmgr
--rmgr=rmgr 只显示由指定资源管理器生成的记录。如果把list作为资源管理器名称
传递给这个选项,则打印出可用资源管理器名称的列表然后退出。
- -s start
--start=start 要从哪个日志位置开始读取。默认是从找到的最早的文件的第一个可用日志记录开始。
- -t timeline
--timeline=timeline 要从哪个时间线读取日志记录。默认是使用startseg(如果指定)
中的值,否则默认为 1。
- -V
--version 打印pg_xlogdump版本并且退出。
- -x xid
--xid=xid 只显示用给定事务 ID 标记的记录。
- -z
--stats[=record] 显示概括统计信息(记录的数量和尺寸以及全页镜像)而不是显示
每个记录。可以选择针对每个记录生成统计信息,而不是针对每个
资源管理器生成。
- -?
--help 显示有关pg_xlogdump命令行参数的帮助并且退出。
注解
当服务器正在运行时可能会给出错误的结果。
只有指定的时间线 会被显示(如果没有指定,则显示默认时间线)。
其他时间线上的记录会被忽略。
pg_xlogdump不能读取具有后缀.partial
的 WAL 文件。如果需要读取那些文件,需要从文件名中移除
.partial后缀。