PostgreSQLサーバのバックアップを行うイメージ図

仕事・AI

PostgreSQLのデータベース全体を安全にバックアップ&リストアする実践手順

PostgreSQLのデータベース全体を安全にバックアップし、正しくリストアするためには公式のpg_dumpallユーティリティを使い、適切な権限・手順・オプションに沿って操作することが重要です。

PostgreSQL全体をバックアップする最適な方法とは?

PostgreSQLでデータベース全体をバックアップする最適な方法は、公式ユーティリティであるpg_dumpallの利用です。

pg_dumpでは個別のデータベース単位のバックアップとなる一方、pg_dumpallはクラスタ内の全データベース(つまり全セット)を1つのSQLスクリプトにまとめて抽出します。

このスクリプトにはユーザやテーブル空間など、全データベースで共通するグローバルオブジェクトも含まれるため、復元時に権限設定や全体の構成ごと再現が可能です。

バックアップは基本的にコマンドラインから『pg_dumpall > ファイル名』の形で取得でき、標準では出力内容がターミナルに表示されるため、ファイルへのリダイレクトや-fオプションで保存先を指定するのが基本的な運用です。

完全なバックアップを作成するには、原則としてスーパーユーザ権限が必要となります。

パスワード認証を使用している環境では複数回入力が求められますが、~/.pgpassファイルを用意しておけば自動入力が可能です。

全体バックアップの運用は、システム障害時のクラスタ丸ごとの移行や複数データベースを横断した復元が必要な場面で威力を発揮します。

バックアップファイルはSQLスクリプト形式となるため、psqlコマンドで容易にリストアできますが、クラスタの状態や環境に合わせて適切なオプションや除外設定を選ぶことが重要となります。

pg_dumpallのコマンド例と主要オプションの活用ポイント

pg_dumpallを使ったバックアップで最低限覚えておきたいのが、具体的なコマンド例と主要オプションの組み合わせです。

基本のコマンドは『pg_dumpall > db.out』。

-f(--file)オプションを利用すれば、『pg_dumpall -f db.out』というふうに、直接ファイルに出力可能です。

データのみを抽出したい場合には-a(--data-only)、定義のみ欲しい場合は-s(--schema-only)で切り替えられます。

リストア先の環境に既存DB等があって上書きが必要な場合には、-c(--clean)を追加するのが有効です。

復元時に不要なエラーを減らしたければ--if-existsを併用します。

権限やスーパーユーザでないユーザでリストアしたいなら-O(--no-owner)の指定も検討する余地があります。

パスワード認証が何度も求められる煩雑さを解消するために、~/.pgpassファイルの設定は定番テクです。

また、実際のリストアでは『psql -X -f db.out -d postgres』と、-X(--no-psqlrc)でpsqlの設定ファイル(psqlrc)を読み込まない形を推奨。

これは、ユーザーごと異なるローカル設定がトラブルを引き起こすのを避けるためです。

なお、ダンプファイルには全てのデータベース作成や、権限、グローバルオブジェクトのコマンドが含まれるため、リストア時もスーパーユーザ権限が必須と言えます。

典型的なバックアップ/リストア作業では、-v(--verbose)で進捗やエラー詳細を確認しつつ、万一のトラブルに備えた運用が現実的です。

バックアップの実践手順:全体・部分・除外パターンの使い分け

バックアップ作業は全体ダンプだけでなく、状況に応じて部分的な抽出や除外のパターン分けが重要です。

クラスタ全体をバックアップしたい場合、基本形は『pg_dumpall > db.out』。

特定のデータベースのみをバックアップから除外したい場合は--exclude-database=パターンを活用します。

たとえば『pg_dumpall --exclude-database=testdb > db.out』のようにすることで、testdbを除外して全体をダンプできます。

また、『--filter=ファイル名』オプションで複数データベースの除外パターンをファイルとしてまとめることも可能です。

一方で、DB全体ではなくユーザーやテーブル空間などグローバルオブジェクトだけをバックアップしたい場合には-g(--globals-only)が使えます。

逆に、ロールのみなら-r(--roles-only)、テーブル空間だけなら-t(--tablespaces-only)、と他にも区分けできます。

このようにオプションで必要な情報を柔軟に抽出できるため、大規模システムや多人数運用のバックアップ管理にも対応しやすいのが特徴です。

部分的バックアップではpg_dump(個別DB単位)やテーブル指定ダンプも考えられますが、システム全体の一貫性を維持するにはpg_dumpallが信頼度高めです。

ただし『部分的なダンプや復元でも、リストア時にはスーパーユーザの任意コードが実行されること』には常に注意が必要で、特に外部から取得したダンプの内容検証は欠かせません。

リストア時の手順と気をつけたい落とし穴

バックアップしたSQLスクリプトをリストアするには、psqlコマンドを使います。

代表的な手順は『psql -X -f db.out -d postgres』の形です。

ここで-X(--no-psqlrc)を付けることで、psqlの標準設定ファイルによる影響を抑え、よりクリーンにリストアできます。

ダンプ側とリストア側でロール名やスーパーユーザ名が異なる場合には、CREATE ROLEなどで『role already exists』といったエラーが起きがちですが、これは無害なものがほとんど。

リストア先に既存のDBやテーブルが残っている場合には、pg_dumpallで-c(--clean)と--if-existsを使ってDROP ... IF EXISTSを事前に行うことで、不要なエラーや重複作成を防げます。

ただ、これでも一部エラーが完全になくなるわけではないため、復元スクリプトの完走だけに頼らず、エラー発生箇所や内容を確認しましょう。

また、デフォルト以外のテーブル空間内にあるDBの場合は、あらかじめ必要なディレクトリが存在しているか確かめておく必要があります。

万一ディレクトリがないと生成そのものが失敗します。

リストア直後はDBの統計情報が不足しているため、必ずANALYZEや『vacuumdb -a -z』で全体を解析し、オプティマイザの性能が落ちないように仕上げましょう。

スクリプトにはpsql独自のメタコマンドが含まれる場合があるので、リストアは必ずpsqlを明示して実施するのが安全です。

PostgreSQL全体バックアップ・リストア運用時の注意点とリスク回避策

本番環境でバックアップ・リストアを安全に運用するために押さえておきたい注意点はいくつもあります。

まず、ダンプやリストアの実行には基本的にスーパーユーザ権限が要るため、関係者以外には決してアクセス権を与えないことが求められます。

部分的バックアップやリストアでも、ダンプファイル内のSQLコードがリストア先で無制限に動作することから、不正な手順や悪意あるコード混入のリスク対策として、復元前の内容チェックは必須。

ファイル内容が巨大となる場合はディスク容量やI/Oに充分余裕をもって進め、途中停電やOSクラッシュなど非常時リスクも視野に入れて運用時間やタイミングを検討しましょう。

ダンプやリストアの進行・完了メッセージは-v(冗長)モードで記録し、万一失敗した際の比較検証や再実行にも備えます。

もしダンプファイルにpg_dumpall独自のメタコマンドやpsql依存の命令が含まれていればpsql以外での復元は正しく行われません。

クラスタバージョン違い(例えばダンプとリストア先のPostgreSQLバージョン差異)がある際は--quote-all-identifiersなどのオプションも活用し、SQL構文や予約語の互換性不具合を抑えることが大切です。

定期的なバックアップ取得と自動化の検討も推奨されますが、その際にも権限や設定ファイルの安全性を決して怠ってはいけません。

参考資料(調査日:2026-11-15)

  • www.postgresql.jp:pg_dumpall(公開日未確認)