2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel

70.1. 备份清单顶层对象 #

备份清单 JSON 文档包含以下键。

PostgreSQL-Backup-Manifest-Version

对应的值是一个整数。在 PostgreSQL 17 开始的版本中,此值为 2;在旧版本中,此值为 1

System-Identifier

进行备份的 PostgreSQL 实例的数据库系统标识符。仅当 PostgreSQL-Backup-Manifest-Version2 时,此字段才存在。

文件

对应的值始终是一个对象列表,每个对象描述备份中存在的一个文件。此列表中不包含使用备份所需的 WAL 文件或备份清单本身。列表中每个对象的结构在第 70.2 节中进行了描述。

WAL-Ranges

对应的值始终是一个对象列表,每个对象描述为了使用备份必须在一个特定时间线中可读的 WAL 记录范围。这些对象的结构在第 70.3 节中进一步描述。

Manifest-Checksum

此键始终出现在备份清单文件的最后一行。对应的值是所有前置行的 SHA-256 校验和。我们在此处使用固定的校验和方法,以便客户端能够对清单进行增量解析。虽然 SHA-256 校验和比 CRC-32C 校验和成本显著更高,但清单通常足够小,额外的计算量不会造成太大影响。

提交更正

如果您在文档中发现任何不正确之处、与您的实际使用体验不符或需要进一步澄清的内容,请使用此表单报告文档问题。