バージョンごとのドキュメント一覧

69.1. バックアップマニフェストの最上位レベルオブジェクト #

<title>Backup Manifest Top-level Object</title>

The backup manifest JSON document contains the following keys. バックアップマニフェストのJSONドキュメントには以下のキーがあります。

PostgreSQL-Backup-Manifest-Version

The associated value is an integer. Beginning in <productname>PostgreSQL</productname> <literal>17</literal>, it is <literal>2</literal>; in older versions, it is <literal>1</literal>. 《機械翻訳》関連付けられた値は整数です。 PostgreSQL17以降は2で、古いバージョンでは1です。

System-Identifier

The database system identifier of the <productname>PostgreSQL</productname> instance where the backup was taken. This field is present only when <literal>PostgreSQL-Backup-Manifest-Version</literal> is <literal>2</literal>. 《機械翻訳》バックアップが取得されたPostgreSQLインスタンスのデータベースシステム識別子。 このフィールドは、PostgreSQL-Backup-Manifest-Version2の場合にのみ存在します。

Files

The associated value is always a list of objects, each describing one file that is present in the backup. No entries are present in this list for the WAL files that are needed in order to use the backup, or for the backup manifest itself. The structure of each object in the list is described in <xref linkend="backup-manifest-files" />. 関連付けられた値は常にオブジェクトのリストで、それぞれがバックアップ中にある一つのファイルを記述しています。 このリストにはバックアップを使うために必要なWALファイルやバックアップマニフェスト自体に対するエントリは含まれません。 リスト内の各オブジェクトの構造は69.2で説明します。

WAL-Ranges

The associated value is always a list of objects, each describing a range of WAL records that must be readable from a particular timeline in order to make use of the backup. The structure of these objects is further described in <xref linkend="backup-manifest-wal-ranges" />. 関連付けられた値は常にオブジェクトのリストで、それぞれがバックアップを使用するために特定タイムラインから読み込み可能でなければならないWALレコードの範囲を記述しています。 これらオブジェクトの構造は後段の69.3で説明します。

Manifest-Checksum

This key is always present on the last line of the backup manifest file. The associated value is a SHA256 checksum of all the preceding lines. We use a fixed checksum method here to make it possible for clients to do incremental parsing of the manifest. While a SHA256 checksum is significantly more expensive than a CRC32C checksum, the manifest should normally be small enough that the extra computation won't matter very much. このキーは常にバックアップマニフェストファイルの最後の行にあります。 関連付けられた値はこれ以前の全行のSHA256チェックサムです。 クライアントでマニフェストの逐次的な解析を可能とするため、ここでは固定のチェックサム方式を使います。 SHA256チェックサムはCRC32Cチェックサムよりもかなり高コストですが、マニフェストは通常、追加の計算が大きな問題とならない程度に小さいはずです。