选择 打开 改范围 完整检索页
受支持版本: 当前版本 (18) / 当前版本 (18) / 17 / 17 / 16 / 16 / 15 / 15 / 14 / 14
开发版本: 19 / 19 / devel / devel
不受支持的版本: 13 / 13 / 12 / 12 / 11 / 10
当前 PostgreSQL 版本不在支持生命周期内。
您可以参阅当前版本的对应页面,或其他在上面列出的活跃大版本。

pg_waldump

pg_waldump — 以人类可读形式显示PostgreSQL数据库集簇的预写式日志

Synopsis

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

描述

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

该工具只能由安装服务器的用户运行,因为它要求对数据目录具有只读访问权限。

选项

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

startseg

从指定的 WAL 段文件开始读取。这会隐式决定搜索文件时所使用的路径以及要使用的时间线。

endseg

读取完指定的 WAL 段文件后停止。

-b
--bkp-details

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

-e end
--end=end

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

-f
--follow

在到达有效 WAL 的末尾后,继续每秒轮询一次,等待新的 WAL 出现。

-n limit
--limit=limit

显示指定数量的记录,然后停止。

-p path
--path=path

指定一个用于搜索 WAL 段文件的目录,或者指定一个包含 pg_wal子目录且其中包含此类文件的目录。默认会在当前目录、 当前目录的pg_wal子目录以及PGDATApg_wal子目录中搜索。

-q
--quiet

除错误外不打印任何输出。如果只想知道一段 WAL 记录能否被成功解析, 而不关心记录内容,则此选项会很有用。

-r rmgr
--rmgr=rmgr

仅显示由指定资源管理器生成的记录。如果传入的名称为list,则打印有效资源管理器名称的列表并退出。

-s start
--start=start

从指定的 WAL 位置开始读取。默认会从找到的最早文件中的第一条有效 WAL 记录开始读取。

-t timeline
--timeline=timeline

读取日志记录时所使用的时间线。如果指定了startseg,默认使用其中的值;否则默认值为 1。

-V
--version

打印pg_waldump的版本并退出。

-x xid
--xid=xid

仅显示标记有给定事务 ID 的记录。

-z
--stats[=record]

显示汇总统计信息(记录和整页镜像的数量及大小),而不是单条记录。也可以选择按记录而不是按资源管理器生成统计信息。

-?
--help

显示pg_waldump命令行参数的帮助信息,并退出。

环境

PGDATA

数据目录;另请参阅-p选项。

PG_COLOR

指定是否在诊断消息中使用颜色。可能的值为alwaysautonever

注解

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

只显示指定的时间线(如果未指定,则使用默认时间线)。 其他时间线中的记录会被忽略。

pg_waldump不能读取带有.partial后缀的 WAL 文件。如果需要读取这些文件,则必须从文件名中移除.partial 后缀。