备份清单 JSON 文档包含以下键。
PostgreSQL-Backup-Manifest-Version
对应的值是一个整数。在 PostgreSQL 17
开始的版本中,此值为 2
;在旧版本中,此值为 1
。
System-Identifier
进行备份的 PostgreSQL 实例的数据库系统标识符。仅当 PostgreSQL-Backup-Manifest-Version
为 2
时,此字段才存在。
文件
对应的值始终是一个对象列表,每个对象描述备份中存在的一个文件。此列表中不包含使用备份所需的 WAL 文件或备份清单本身。列表中每个对象的结构在第 70.2 节中进行了描述。
WAL-Ranges
对应的值始终是一个对象列表,每个对象描述为了使用备份必须在一个特定时间线中可读的 WAL 记录范围。这些对象的结构在第 70.3 节中进一步描述。
Manifest-Checksum
此键始终出现在备份清单文件的最后一行。对应的值是所有前置行的 SHA-256 校验和。我们在此处使用固定的校验和方法,以便客户端能够对清单进行增量解析。虽然 SHA-256 校验和比 CRC-32C 校验和成本显著更高,但清单通常足够小,额外的计算量不会造成太大影响。
如果您在文档中发现任何不正确之处、与您的实际使用体验不符或需要进一步澄清的内容,请使用此表单报告文档问题。