2024 年 9 月 26 日: PostgreSQL 17 发布!
支持版本:当前 (17)
开发版本:devel

pg_walsummary

pg_walsummary — 打印 WAL 摘要文件的内容

概要

pg_walsummary [选项...] [文件...]

描述

pg_walsummary 用于打印 WAL 摘要文件的内容。这些二进制文件位于数据目录的 pg_wal/summaries 子目录中,可以使用此工具将其转换为文本。这通常不需要,因为 WAL 摘要文件主要存在于支持 增量备份,但它可能对调试目的有用。

WAL 摘要文件按表空间 OID、关系 OID 和关系分支进行索引。对于每个关系分支,它存储由 WAL 在文件中汇总的范围内修改的块列表。它还可以存储一个“限制块”,如果关系分支是在相关 WAL 范围内创建或截断的,则该块为 0,否则是关系分支截断的最短长度。如果关系分支在相关 WAL 范围内没有创建、删除或截断,则限制块是未定义的或无限的,并且不会由此工具打印。

选项

-i
--individual

默认情况下,pg_walsummary 为每个包含一个或多个连续修改块的范围打印一行输出。这可以使输出更简洁,因为所有从 0 到 999 的块都被修改的关系将只产生一行输出,而不是 1000 行单独的输出。此选项请求为每个修改的块输出单独的行。

-q
--quiet

除了错误外,不打印任何输出。当您想了解 WAL 摘要文件是否可以成功解析,但不在乎内容时,这很有用。

-V
--version

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

-?
--help

显示关于 pg_walsummary 命令行参数的帮助信息,然后退出。

环境

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

提交更正

如果您在文档中发现任何错误,与您对特定功能的体验不符,或者需要进一步说明,请使用 此表格 报告文档问题。