pg_walsummary — 打印 WAL 摘要文件的内容
pg_walsummary [option...] [file...]
pg_walsummary 用于打印 WAL 摘要文件的内容。这些二进制文件位于数据目录的 pg_wal/summaries 子目录中,可以使用这个工具把它们转换成文本。这通常没有必要,因为 WAL 摘要文件主要是为了支持 incremental backup 而存在的,但它可能在调试时有用。
一个 WAL 摘要文件以表空间 OID、关系 OID 和关系分叉为索引。对于每一个关系分叉,它存储在该文件所汇总的范围之内被 WAL 修改过的块的列表。它还可以存储一个“界限块”,如果在相关的 WAL 范围内该关系分叉被创建或者被截断,则界限块为 0,否则为该关系分叉曾被截断到的最短长度。如果该关系分叉在相关的 WAL 范围内没有被创建、删除或者截断,则界限块是未定义的或者无穷大的,并且不会被这个工具打印出来。
-i--individual
默认情况下,pg_walsummary 会为每个由一个或多个连续被修改块组成的范围打印一行输出。这样可以使输出精简很多,因为一个块 0 到块 999 全部被修改的关系将只会产生一行输出,而不是 1000 行单独的输出。此选项要求为每个被修改的块单独输出一行。
-q--quiet除错误之外不打印任何输出。当你想知道一个 WAL 摘要文件能否被成功解析、但并不关心其内容时,这个选项会很有用。
-V--version显示版本信息,然后退出。
-?--help显示关于 pg_walsummary 命令行参数的帮助,然后退出。
环境变量 PG_COLOR 指定是否在诊断消息中使用颜色。可能的值是 always、auto 和 never。