pg_waldump

pg_waldump — 显示PostgreSQL数据库集群的预写式日志的可读渲染

语法

pg_waldump[选项...] [startseg[endseg]]

说明

pg_waldump显示预写式日志 (WAL)，主要用于调试或教育目的。

此实用程序只能由安装服务器的用户运行，因为它需要对数据目录的只读访问权限。

选项

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

startseg

从指定的 WAL 段文件开始读取。这会隐式确定将在其中搜索文件的路径，以及要使用的时间线。

endseg

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

-b
--bkp-details

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

-B block
--block=block

仅显示修改给定块的记录。还必须使用 --relation 或 -R 提供关系。

-e end
--end=end

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

-f
--follow

在达到有效 WAL 的末尾后，每秒轮询一次，以查看是否存在新 WAL。

-F fork
--fork=fork

如果提供了此选项，则仅显示修改给定 fork 中块的记录。有效值为 main（主 fork）、fsm（空闲空间映射）、vm（可见性映射）和 init（init fork）。

-n limit
--limit=limit

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

-p path
--path=path

指定一个目录以搜索 WAL 段文件或包含此类文件的 pg_wal 子目录的目录。默认情况下，将在当前目录、当前目录的 pg_wal 子目录和 PGDATA 的 pg_wal 子目录中进行搜索。

-q
--quiet

不打印任何输出，除了错误。当您想知道一系列 WAL 记录是否可以成功解析，但不在乎记录内容时，此选项很有用。

-r rmgr
--rmgr=rmgr

仅显示由指定的资源管理器生成的记录。您可以多次指定选项以选择多个资源管理器。如果将 list 作为名称传递，则打印有效的资源管理器名称列表，然后退出。

扩展可以定义自定义资源管理器，但 pg_waldump 不会加载扩展模块，因此不会按名称识别自定义资源管理器。相反，您可以将自定义资源管理器指定为 custom###，其中“###”是三位数的资源管理器 ID。此类形式的名称将始终被视为有效名称。

-R tblspc/db/rel
--relation=tblspc/db/rel

仅显示修改给定关系中的块的记录。关系使用表空间 OID、数据库 OID 和 relfilenode 指定，这些内容由斜杠分隔，例如 1234/12345/12345。这是程序输出中关系使用的相同格式。

-s start
--start=start

开始读取 WAL 的 WAL 位置。默认情况下，从在最早找到的文件中找到的第一个有效 WAL 记录开始读取。

-t timeline
--timeline=timeline

从其读取 WAL 记录的时间线。默认情况下，使用 startseg 中的值（如果指定了该值）；否则，默认值为 1。该值可以用十进制或十六进制指定，例如 17 或 0x11。

-V
--version

打印 pg_waldump 版本并退出。

-w
--fullpage

仅显示包含全页图像的记录。

-x xid
--xid=xid

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

-z
--stats[=record]

显示汇总统计信息（记录和全页图像的数量和大小），而不是单个记录。可以选择生成按记录而不是按 rmgr 划分的统计信息。

如果 pg_waldump 被信号 SIGINT (Control+C) 终止，则会显示到终止点为止计算的统计信息的摘要。此操作不受 Windows 支持。

--save-fullpage=save_path

将 WAL 记录中找到的整页图像保存到 save_path 目录。保存的图像受与显示的记录相同的筛选和限制条件的约束。

整页图像使用以下文件名格式保存：TIMELINE-LSN.RELTABLESPACE.DATOID.RELNODE.BLKNOFORK 文件名由以下部分组成

组件	说明
TIMELINE	记录所在的 WAL 段文件的时间线，格式为一个 8 位十六进制数字 %08X
LSN	带有此图像的记录的 ，格式为两个 8 位十六进制数字 %08X-%08X
RELTABLESPACE	块的表空间 OID
DATOID	块的数据库 OID
RELNODE	块的文件节点
BLKNO	块的块号
FORK	整页图像的来源分叉的名称，例如 _main、_fsm、_vm 或 _init。

-?
--help

显示有关 pg_waldump 命令行参数的帮助，然后退出。

环境

PGDATA

数据目录；另请参见 -p 选项。

PG_COLOR

指定是否在诊断消息中使用颜色。可能的值为 always、auto 和 never。

注释

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

仅显示指定的时间线（或未指定时显示默认时间线）。其他时间线中的记录将被忽略。

pg_waldump无法读取后缀为.partial的 WAL 文件。如果需要读取这些文件，则需要从文件名中删除.partial后缀。

另请参见

第 30.6 节