pg_walsummary
pg_walsummary — 打印 WAL 汇总文件的内容
当前查看 PostgreSQL 18.6。
说明
pg_walsummary — 打印 WAL 汇总文件的内容
- 手册中的可执行程序
- pg_walsummary
- 程序版本
- 18.6
- 参考清单
- 服务端程序
- 选项定义组
- 4
用法
pg_walsummary [ option ...] [ file ...]手册中的选项
| 选项与参数 | 说明 |
|---|---|
| -i --individual | 默认情况下， pg_walsummary 会为每个由一个或多个连续已修改块构成的范围输出一行。这样可以使输出简洁得多，因为如果某个关系中从 0 到 999 的所有块都被修改了，则只会输出一行，而不是 1000 行单独的输出。该选项要求为每个已修改块分别输出一行。 |
| -q --quiet | 除错误之外不打印任何输出。当只想知道某个 WAL 汇总文件能否被成功解析，而并不关心其内容时，这会很有用。 |
| -V --version | 显示版本信息，然后退出。 |
| -? --help | 显示 pg_walsummary 命令行参数的帮助并退出。 |
手册定义
pg_walsummary
pg_walsummary — 打印 WAL 汇总文件的内容
大纲
pg_walsummary [option...] [file...]
说明
pg_walsummary用于打印 WAL 汇总文件的内容。这些二进制文件位于数据目录下的pg_wal/summaries子目录中，可使用本工具将其转换为文本。通常并无此必要，因为 WAL 汇总文件主要是为了支持增量备份而存在的，但在调试时可能会很有用。
WAL 汇总文件按表空间 OID、关系 OID 以及关系分支（fork）建立索引。对于每个关系分支，它都存储该文件所汇总范围内被 WAL 修改的块列表。它还可以存储一个“界限块”：如果该关系分支在相关 WAL 范围内被创建或截断，则其值为 0；否则，其值为该关系分支被截断后的最短长度。如果该关系分支在相关 WAL 范围内未被创建、删除或截断，则界限块未定义，或者为无穷大，本工具不会打印它。
选项
-i--individual-
默认情况下，
pg_walsummary会为每个由一个或多个连续已修改块构成的范围输出一行。这样可以使输出简洁得多，因为如果某个关系中从 0 到 999 的所有块都被修改了，则只会输出一行，而不是 1000 行单独的输出。该选项要求为每个已修改块分别输出一行。 -q--quiet-
除错误之外不打印任何输出。当只想知道某个 WAL 汇总文件能否被成功解析，而并不关心其内容时，这会很有用。
-V--version-
显示版本信息，然后退出。
-?--help-
显示pg_walsummary命令行参数的帮助并退出。
环境
环境变量PG_COLOR指定是否在诊断消息中使用颜色。可能的值为always、auto和never。
文档与源码
来源构建
- 版本
- 18.6
- 构建
- https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
- 来源指纹
ee8d1a3612338fd9adf250730cb640fcc5233b5491337cc00a316a44e3a0b9f8
版本比较
PostgreSQL 18 → 19: 属性变化。
以下差异保留原始字段名与英文源描述。
--- PostgreSQL 18
+++ PostgreSQL 19
@@ -35,6 +35,6 @@
}
],
"synopsis": [
- "pg_walsummary [ option ...] [ file ...]"
+ "pg_walsummary [ option ...] [ filename ...]"
]
}比较已记录的接口与属性，排除来源指纹和构建元数据。某个样本中没有记录，不能据此判断实际引入或移除的版本。
相关条目
导出 JSON · 返回命令行工具 · 收录范围为 PostgreSQL 17 至 20；最早采样版本不一定是实际引入版本。