3.8. 継続的にアーカイブして PostgreSQL データのバックアップを作成

手順

1. /var/lib/pgsql/data/postgresql.conf ファイルで以下を行います。

   1. wal_level 設定パラメーターを replica 以降に設定します。
   2. archive_mode パラメーターを on に設定します。

   3. archive_command 設定パラメーターでシェルコマンドを指定します。cp コマンド、別のコマンド、またはシェルスクリプトを使用できます。

      以下に例を示します。

      archive_command = 'test ! -f /mnt/server/archivedir/%f && cp %p /mnt/server/archivedir/%f'

      Copy to Clipboard Toggle word wrap

      %p パラメーターは、アーカイブするファイルの相対パスに置き換えられ、%f パラメーターはファイル名に置き換えられます。

      このコマンドは、アーカイブ可能な WAL セグメントを /mnt/server/archivedir/ ディレクトリーにコピーします。%p パラメーターおよび %f パラメーターを置き換えると、実行されたコマンドは以下のようになります。

      test ! -f /mnt/server/archivedir/00000001000000A900000065 && cp pg_wal/00000001000000A900000065 /mnt/server/archivedir/00000001000000A900000065

      Copy to Clipboard Toggle word wrap

      アーカイブされる新規ファイルごとに同様のコマンドが生成されます。

      注記

      archive コマンドは、完了した WAL セグメントでのみ実行されます。WAL トラフィックをほとんど生成しないサーバーでは、トランザクションの完了とアーカイブストレージへの安全な記録の間にかなりの遅延が生じる可能性があります。アーカイブされていないデータの古さを制限するには、以下を行います。

      • archive_timeout パラメーターを設定して、サーバーが特定の頻度で新しい WAL セグメントファイルに切り替えるように強制します。
      • pg_switch_wal パラメーターを使用して、セグメント切り替えを強制し、トランザクションが終了後すぐにアーカイブされるようにします。

2. postgresql サービスを再起動して、変更を適用します。

   # systemctl restart postgresql.service

   Copy to Clipboard Toggle word wrap
3. アーカイブコマンドをテストし、既存のファイルが上書きされないこと、失敗した場合にゼロ以外の終了ステータスが返されることを確認します。
4. データを保護するには、セグメントファイルがグループまたはワールド読み取りアクセスを持たないディレクトリーにアーカイブされていることを確認してください。

手順

1. pg_basebackup ユーティリティーを使用してベースバックアップを実行します。

   • 個々のファイル (プレーン形式) としてベースバックアップを作成するには、以下を実行します。

     $ pg_basebackup -D <backup_directory> -Fp

     Copy to Clipboard Toggle word wrap

     backup_directory は、任意のバックアップの場所に置き換えます。

     テーブルスペースを使用し、サーバーと同じホストでベースバックアップを実行する場合は、--tablespace-mapping オプションも使用する必要があります。そうしないと、バックアップを同じ場所に書き込もうとすると、バックアップが失敗します。

   • tar アーカイブ (tar および圧縮形式) としてベースバックアップを作成するには、以下を実行します。

     $ pg_basebackup -D <backup_directory> -Ft -z

     Copy to Clipboard Toggle word wrap

     backup_directory は、任意のバックアップの場所に置き換えます。

     このようなデータを復元するには、ファイルを正しい場所に手動で抽出する必要があります。

   pg_basebackup が接続するデータベースサーバーを指定するには、以下のコマンドラインオプションを使用します。

   • ホストを定義する -h オプション

     デフォルトのホストは、ローカルホストまたは PGHOST 環境変数により指定されたホストです。

   • ポートを定義する -p オプション

     デフォルトのポートは、PGPORT 環境変数またはコンパイル済みデフォルトで示されます。

2. ベースバックアッププロセスが完了すると、バックアップ履歴ファイルで指定されている、データベースクラスターのコピーとバックアップ中に使用された WAL セグメントファイルを安全にアーカイブします。
3. ベースバックアップで使用されている WAL セグメントファイルよりも数値が小さい WAL セグメントを削除します。これらはベースバックアップよりも古く、復元には必要ないためです。

手順

1. サーバーを停止します。

   # systemctl stop postgresql.service

   Copy to Clipboard Toggle word wrap

2. 必要なデータを一時的な場所にコピーします。

   必要に応じて、クラスターデータのディレクトリー全体と、すべてのテーブルスペースをコピーします。既存データベースのコピーを 2 つ保持するには、システムに十分な空き領域が必要になることに注意してください。

   十分なスペースがない場合は、システムがダウンする前にアーカイブされなかったログが含まれている可能性がある、クラスターの pg_wal ディレクトリーの内容を保存します。

3. クラスターデータディレクトリー、および使用しているテーブルスペースのルートディレクトリー下の既存ファイルおよびサブディレクトリーをすべて削除します。

4. ベースバックアップからデータベースファイルを復元します。

   以下の点を確認してください。

   • ファイルは、正しい所有権 (root ではなくデータベースシステムのユーザー) で復元されます。
   • ファイルは、正しいパーミッションで復元されます。
   • pg_tblspc/ サブディレクトリーのシンボリックリンクが正しく復元されます。

5. pg_wal/ サブディレクトリーにあるファイルをすべて削除します。

   このファイルは、ベースバックアップから作成されるため、非推奨になりました。pg_wal/ をアーカイブしていない場合は、適切なパーミッションで再作成します。

6. 手順 2 で保存したアーカイブされていない WAL セグメントファイルを pg_wal/ にコピーします。

7. クラスターデータディレクトリーの recovery.conf リカバリーコマンドファイルを作成し、restore_command 設定パラメーターでシェルコマンドを指定します。cp コマンド、別のコマンド、またはシェルスクリプトを使用できます。以下に例を示します。

   restore_command = 'cp /mnt/server/archivedir/%f "%p"'

   Copy to Clipboard Toggle word wrap

8. サーバーを起動します。

   # systemctl start postgresql.service

   Copy to Clipboard Toggle word wrap

   サーバーは復元モードに入り、引き続き必要なアーカイブファイル (WAL) を読み込みます。

   外部エラーにより復元が終了した場合は、サーバーを再起動して復元を続行します。復元プロセスが完了すると、サーバーは recovery.conf の名前を recovery. done に変更します。これにより、サーバーが通常のデータベース操作を開始した後に、誤ってリカバリーモードに戻るのを防ぐことができます。

9. データベースのコンテンツを確認して、データベースが必要な状態に復元されたことを検証します。

   データベースが必要な状態に復元されていない場合は、手順 1 に戻ります。データベースが必要な状態に復元された場合は、pg_hba.conf ファイル内のクライアント認証設定を復元して、ユーザーが接続できるようにします。