pg_walsummary — print contents of WAL summary files
pg_walsummary [option...] [file...]
<application>pg_walsummary</application> is used to print the contents of
WAL summary files. These binary files are found with the
<literal>pg_wal/summaries</literal> subdirectory of the data directory,
and can be converted to text using this tool. This is not ordinarily
necessary, since WAL summary files primarily exist to support
<link linkend="backup-incremental-backup">incremental backup</link>,
but it may be useful for debugging purposes.
pg_walsummaryは、WAL要約ファイルの内容を出力するために使用します。
これらのバイナリファイルは、データディレクトリのpg_wal/summariesサブディレクトリにあり、このツールを使用してテキストに変換できます。
これは通常は必要ありません。
WAL要約ファイルは主に増分バックアップをサポートするために存在しますが、デバッグ目的で有用な場合があります。
A WAL summary file is indexed by tablespace OID, relation OID, and relation fork. For each relation fork, it stores the list of blocks that were modified by WAL within the range summarized in the file. It can also store a "limit block," which is 0 if the relation fork was created or truncated within the relevant WAL range, and otherwise the shortest length to which the relation fork was truncated. If the relation fork was not created, deleted, or truncated within the relevant WAL range, the limit block is undefined or infinite and will not be printed by this tool. WAL要約ファイルは、テーブル空間OID、リレーションOID、およびリレーションフォークによってインデックス付けされます。 各リレーションフォークに対して、WALによって変更されたブロックのリストをファイル内で要約された範囲で保存します。 また、"limit block"を保存することもできます。 これは、リレーションフォークが関連するWAL範囲内で作成または切り捨てられた場合は0、それ以外の場合はリレーションフォークが切り捨てられた最短の長さを保持します。 リレーションフォークが関連するWAL範囲内で作成、削除、または切り捨てられていない場合、limitブロックは未定義または無限であり、このツールでは出力されません。
-i--individual
By default, <literal>pg_walsummary</literal> prints one line of output
for each range of one or more consecutive modified blocks. This can
make the output a lot briefer, since a relation where all blocks from
0 through 999 were modified will produce only one line of output rather
than 1000 separate lines. This option requests a separate line of
output for every modified block.
デフォルトでは、pg_walsummaryは、連続する1つ以上の変更されたブロックの範囲ごとに1行の出力を出力します。
これにより、0から999までのすべてのブロックが変更されたリレーションは、1000の別々の行ではなく、1行の出力しか生成しないため、出力を非常に簡潔にすることができます。
このオプションは、変更されたブロックごとに別々の行を出力するように要求します。
-q--quietDo not print any output, except for errors. This can be useful when you want to know whether a WAL summary file can be successfully parsed but don't care about the contents. エラー以外の出力を表示しません。 これは、WAL要約ファイルが正常に解析できたかどうかを知りたいがレコードの内容を気にしない場合には有用でしょう。
-V--versionDisplay version information, then exit. バージョン情報を表示して終了します。
-?--helpShows help about <application>pg_walsummary</application> command line arguments, and exits. pg_walsummaryコマンドライン引数の使用方法を表示し、終了します。
The environment variable <envar>PG_COLOR</envar> specifies whether to use
color in diagnostic messages. Possible values are
<literal>always</literal>, <literal>auto</literal> and
<literal>never</literal>.
環境変数PG_COLORは診断メッセージで色を使うかどうかを指定します。
指定可能な値はalways、auto、neverです。