PostgreSQLをバックアップするには|pg_dumpの対象と復元確認

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のエラー処理

所有者や権限の復元に必要なロールが不足すると、元の状態を再現できません。所有者を無視するオプションでエラーを消した場合は、権限まで復元できたと判断しないでください。

復元後は業務に必要な内容を照合する

確認項目 確認例
構造 必要なテーブル、ビュー、インデックスがあるか
データ 重要テーブルの件数や代表データが期待どおりか
権限 想定する利用者で必要な操作ができるか
動作 アプリケーションの主要な参照・更新が成立するか
時間 準備から検証終了までどれだけかかったか

比較対象はバックアップ時点に対応させます。取得後も更新される本番の現在件数と単純比較すると、正常な差分まで異常と扱いかねません。件数一致だけでは内容の一致も証明できないため、業務上重要な条件を加えます。

これらのコマンドは説明例で、実環境での実行結果ではありません。復旧目標に対して論理バックアップで足りるかを含め、構成と検証結果を整理しましょう。インフラ運用のご相談はお問い合わせから受け付けています。

記事一覧へ戻る

ITの困りごとを、
まずはご相談ください。

何から手をつけるか決まっていない段階でも構いません。ご相談内容に応じて、担当者からご連絡します。

まずは相談する

採用へのご応募は採用エントリーからお願いします。