备份清单 JSON 文档包含以下键。
PostgreSQL-Backup-Manifest-Version其对应的值是一个整数。从 PostgreSQL 17 开始,该值为 2;在较早的版 本中,该值为 1。
System-Identifier执行该备份的 PostgreSQL 实例的数据库系统标识 符。只有当 PostgreSQL-Backup-Manifest-Version 为 2 时,才会出现该字段。
Files其对应的值总是一个对象列表,其中每个对象描述备份中存在的一个文件。为 了使用该备份所需的 WAL 文件,以及备份清单文件本身,都不会在此列表中出 现条目。该列表中每个对象的结构见 Section 68.2。
WAL-Ranges其对应的值总是一个对象列表,其中每个对象描述一个 WAL 记录范围。为了使 用该备份,必须能够从某条特定时间线上读取该范围内的 WAL 记录。这些对象 的结构在 Section 68.3 中有进一步说 明。
Manifest-Checksum该键总是出现在备份清单文件的最后一行。其对应的值是此前所有行的 SHA-256 校验和。这里使用固定的校验和方法,是为了让客户端能够对清单进 行增量解析。尽管 SHA-256 校验和明显比 CRC-32C 校验和开销更高,但清单 通常足够小,因此这些额外计算一般并不重要。
如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。