pg_waldump — PostgreSQLデータベースクラスタの先行書き込みログを可読性が高い表現で表示する
pg_waldump
[option
...] [startseg
[endseg
]]
pg_waldump
は先行書き出しログ(WAL)を表示します。
主にデバッグや学習目的に有用です。
データディレクトリへの読み取り専用のアクセスが必要ですので、このユーティリティはサーバをインストールしたユーザによってのみ実行することができます。
以下のコマンドラインオプションは場所や出力書式を制御します。
startseg
指定したログセグメントファイルから読み取りを開始します。 これは暗黙的に検索されるファイルのパスや使用するタイムラインを決定します。
endseg
指定したログセグメントファイルを読み取り後終了します。
-b
--bkp-details
バックアップブロックに関する詳細情報を出力します。
-e end
--end=end
ログストリームの終了点まで読み取る代わりに、指定したWAL位置で読み取りを終了します。
-f
--follow
有効なWALの終わりに到達した後、新しいWALが現れるのを1秒間に1回ポーリングし続けます。
-n limit
--limit=limit
指定レコード数を表示し、終了します。
-p path
--path=path
ログセグメントファイルを見つけ出すディレクトリ、あるいはログセグメントファイルが含まれるpg_wal
サブディレクトリが含まれるディレクトリを指定します。
デフォルトではカレントディレクトリ、カレントディレクトリ内のpg_wal
サブディレクトリ、PGDATA
のpg_wal
サブディレクトリから検索されます。
-q
--quiet
エラーを除いて、出力を表示しません。 このオプションは、WALレコードの範囲の解析に成功したかを知りたいがレコードの内容を気にしない場合には有用でしょう。
-r rmgr
--rmgr=rmgr
指定されたリソースマネージャによって生成されたレコードのみを表示します。
list
が名称として渡された場合は、有効なリソースマネージャの一覧を表示します。
-s start
--start=start
読み取りを始めるWAL位置です。 デフォルトでは、最も過去のファイルの中で見つかった最初の有効なログレコードから読み取りを始めます。
-t timeline
--timeline=timeline
ログレコードの読み取り先のタイムラインです。
デフォルトでは、startseg
が指定されている場合はstartseg
内の値が使用されます。
指定がない場合のデフォルトは1です。
-V
--version
pg_waldumpのバージョンを表示し終了します。
-x xid
--xid=xid
指定されたトランザクションIDで印付けられたレコードのみを表示します。
-z
--stats[=record]
個々のレコードの代わりに要約統計(レコードの数とサイズ、および全ページのイメージ)を表示します。 オプションでrmgr毎の代わりにレコード毎の統計を生成します。
-?
--help
pg_waldumpのコマンドライン引数に関する説明を表示し、終了します。
PGDATA
データディレクトリ。-p
オプションも参照してください。
PG_COLOR
診断メッセージで色を使うかどうかを指定します。
可能な値はalways
、auto
、never
です。
サーバが実行中の場合は間違った結果になることがあります。
指定されたタイムラインのみが表示されます(指定がなければデフォルトのみが表示)。 他のタイムラインのレコードは無視されます。
pg_waldumpは拡張子.partial
のWALファイルを読むことはできません。
読む必要がある場合は、ファイル名から拡張子.partial
を削除してください。