2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 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

提交更正

如果您在文档中发现任何不正确、不符合您对特定功能的实际体验或需要进一步阐述的内容,请使用 此表单 报告文档问题。