受支持版本: 当前版本 (18) / 17 / 16
开发版本: devel

pg_walsummary

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

Synopsis

pg_walsummary [option...] [file...]

描述

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

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

选项

-i
--individual

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

-q
--quiet

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

-V
--version

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

-?
--help

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

环境

环境变量PG_COLOR用于指定是否在诊断消息中使用颜色。 可能的值为alwaysautonever

提交更正

如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。