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。