↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17
开发中的版本: 19 / 20devel
开发快照。 PostgreSQL 20devel 尚未正式发布,内容仍可能变化。

pg_walsummary

pg_walsummary — 打印 WAL 汇总文件的内容

大纲

pg_walsummary [option...] [filename...]

描述

pg_walsummary 用于打印 WAL 汇总文件的内容。这些二进制文件位于数据目录下的 pg_wal/summaries 子目录中,可使用本工具将其转换为文本。通常并无此必要,因为 WAL 汇总文件主要是为了支持增量备份而存在的,但在调试时可能会很有用。

WAL 汇总文件按表空间 OID、关系 OID 以及关系分支(fork)建立索引。对于每个关系分支,它都存储该文件所汇总范围内被 WAL 修改的块列表。它还可以存储一个“界限块”:如果该关系分支在相关 WAL 范围内被创建或截断,则其值为 0;否则,其值为该关系分支被截断后的最短长度。如果该关系分支在相关 WAL 范围内未被创建、删除或截断,则界限块未定义,或者为无穷大,本工具不会打印它。

选项

filename

指定一个 WAL 汇总文件的名称,该文件位于数据目录的 pg_wal/summaries 子目录中。

-i
--individual

默认情况下,pg_walsummary 会为每个由一个或多个连续已修改块构成的范围输出一行。这样可以使输出简洁得多,因为如果某个关系中从 0 到 999 的所有块都被修改了,则只会输出一行,而不是 1000 行单独的输出。该选项要求为每个已修改块分别输出一行。

-q
--quiet

除错误之外不打印任何输出。当只想知道某个 WAL 汇总文件能否被成功解析,而并不关心其内容时,这会很有用。

-V
--version

显示版本信息,然后退出。

-?
--help

显示 pg_walsummary 命令行参数的帮助并退出。

环境

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

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.