3.6. SQL ダンプを使用した PostgreSQL データのバックアップ

• SQL ダンプは、サーバーのバージョン固有ではない唯一の PostgreSQL バックアップメソッドです。pg_dump ユーティリティーの出力は、PostgreSQL の後続のバージョンにリロードできます。これは、ファイルシステムレベルのバックアップ、または継続的なアーカイブにはできません。
• SQL ダンプは、32 ビットサーバーから 64 ビットサーバーへなど、異なるアーキテクチャーにデータベースを転送する際に有効な唯一の方法です。
• SQL ダンプは、内部的に一貫性のあるダンプを提供します。ダンプは、pg_dump の実行開始時のデータベースのスナップショットを表します。
• pg_dump ユーティリティーは、実行中のデータベースの他の操作をブロックしません。

前提条件

• ダンプするすべてのテーブルへの読み取りアクセスが必要です。データベース全体をダンプするには、postgres のスーパーユーザーまたはデータベースの管理者特権を持つユーザーとして、コマンドを実行する必要があります。

手順

• クラスター全体の情報なしでデータベースをダンプします。

  $ pg_dump <db_name> > <dump_file>

  Copy to Clipboard Toggle word wrap

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

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

    デフォルトのホストは、ローカルホストか、PGHOST 環境変数で指定されているものです。

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

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

前提条件

• postgres スーパーユーザーまたはデータベースの管理者特権を持つユーザーとして、コマンドを実行する必要があります。

手順

• データベースクラスターのすべてのデータベースをダンプし、クラスター全体のデータを保存します。

  $ pg_dumpall > <dump_file>

  Copy to Clipboard Toggle word wrap

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

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

    デフォルトのホストは、ローカルホストか、PGHOST 環境変数で指定されているものです。

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

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

  • デフォルトのデータベースを定義する -l オプション

    このオプションにより、初期化時に自動的に作成された postgres データベースとは異なるデフォルトのデータベースを選択できます。

前提条件

• postgres スーパーユーザーまたはデータベースの管理者特権を持つユーザーとして、コマンドを実行する必要があります。

前提条件

• postgres スーパーユーザーまたはデータベースの管理者特権を持つユーザーとして、コマンドを実行する必要があります。

手順

• データベースを、サーバーから別のサーバーにダンプするには、以下のコマンドを実行します。

  $ pg_dump -h <host_1> <db_name> | psql -h <host_2> <db_name>

  Copy to Clipboard Toggle word wrap

前提条件

• postgres スーパーユーザーまたはデータベースの管理者特権を持つユーザーとして、コマンドを実行する必要があります。

手順

• ON_ERROR_STOP 変数を設定して SQL エラーが発生した場合は、終了ステータス 3 で psql を終了します。

  $ psql --set ON_ERROR_STOP=on <db_name> < <dump_file>

  Copy to Clipboard Toggle word wrap

• ダンプ全体が単一のトランザクションとして復元されるように指定して、復元が完全に完了するかキャンセルされるようにします。

  • psql ユーティリティーを使用してテキストファイルのダンプを復元する場合:

    $ psql -1

    Copy to Clipboard Toggle word wrap

  • pg_restore ユーティリティーを使用してテキストファイル以外のダンプを復元する場合:

    $ pg_restore -e

    Copy to Clipboard Toggle word wrap

  この方法を使用する場合、小さなエラーでも、すでに何時間も実行されている復元操作がキャンセルされる可能性があることに注意してください。