PostgreSQLのバックアップでは、pg_dumpで何を保存できるかを確認し、別環境で復元できるところまで検証します。ダンプファイルの作成成功と、業務を再開できることは別の確認です。本記事はPostgreSQL 18の公式資料を基に、論理バックアップの範囲を整理します。
pg_dumpの対象は一つのデータベース
pg_dumpは一つのデータベースをダンプします。ロールやテーブルスペースの定義はクラスタ全体の情報であり、pg_dumpには含まれません。全体の復旧計画では、pg_dumpallによる取得など、別の準備が必要です。PostgreSQL 18 SQL Dump
データベース内のデータだけでなく、復元先のロール、拡張機能、設定、アプリケーション側の接続条件も確認項目にします。何をこのバックアップで戻し、何を別の管理情報から再構成するかを分けて記録しましょう。
形式に合った復元ツールを選ぶ
テキスト形式のダンプはpsqlで読み込み、カスタム形式などの非テキスト形式はpg_restoreを使用します。以下はカスタム形式の取得と内容一覧の確認例です。
pg_dump -h SOURCE_HOST -U BACKUP_USER -Fc appdb > appdb.dump
pg_restore --list appdb.dump
SOURCE_HOST、BACKUP_USER、appdb は説明用の値です。実行前に接続先、権限、保存先の容量とアクセス制限を確認してください。既存の同名ファイルがあるとリダイレクトで上書きされるため、実際には取得ごとに区別できる保存名を使用します。
--list が表示するのはアーカイブの目次です。これだけで全データの復元が成功することを証明できるわけではありません。pg_restoreの仕様
取得ログと終了状態を記録する
ファイルが存在し、サイズがあるだけで成功扱いにしないでください。実行日時、対象、ツールの版、終了状態、標準エラーの内容を保存します。圧縮や転送を組み合わせる場合は、その各段階の失敗も把握できるようにします。
取得後のファイルは機密データを含み得るため、復元検証へ渡すときも保管先と閲覧範囲を管理します。ハッシュ照合は転送前後の一致確認には使えますが、元のダンプに必要な内容が含まれるかとは別の問題です。
隔離した復元先で試す
復元テストは、本番へ誤接続しない検証用サーバーと空のデータベースで行います。以下は必要なロール等を準備し、template0 から作成した空の restore_check に読み込む説明例です。
pg_restore -h TEST_HOST -U RESTORE_USER --exit-on-error -d restore_check appdb.dump
--exit-on-error はSQL実行中のエラーで処理を終了します。全体を自動でロールバックする指定ではないため、失敗した検証先に続けて上書きするのではなく、原因を直して空の環境から再試行する手順を用意します。pg_restoreのエラー処理
所有者や権限の復元に必要なロールが不足すると、元の状態を再現できません。所有者を無視するオプションでエラーを消した場合は、権限まで復元できたと判断しないでください。
復元後は業務に必要な内容を照合する
| 確認項目 | 確認例 |
|---|---|
| 構造 | 必要なテーブル、ビュー、インデックスがあるか |
| データ | 重要テーブルの件数や代表データが期待どおりか |
| 権限 | 想定する利用者で必要な操作ができるか |
| 動作 | アプリケーションの主要な参照・更新が成立するか |
| 時間 | 準備から検証終了までどれだけかかったか |
比較対象はバックアップ時点に対応させます。取得後も更新される本番の現在件数と単純比較すると、正常な差分まで異常と扱いかねません。件数一致だけでは内容の一致も証明できないため、業務上重要な条件を加えます。
これらのコマンドは説明例で、実環境での実行結果ではありません。復旧目標に対して論理バックアップで足りるかを含め、構成と検証結果を整理しましょう。インフラ運用のご相談はお問い合わせから受け付けています。