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