最終更新日 2020年01月23日(木)

表面上、PG バックアップ​は、Heroku Postgres​ データベースの定期バックアップを取得するための方法を提供します。ただし、その汎用アーキテクチャおよび標準の PostgreSQL ユーティリティの使用のため、これは外部の PostgreSQL データベースとの間のエクスポートやインポートを実行できる有効なツールにもなっています。

エクスポート

PG バックアップでは、ネイティブな pg_dump​ PostgreSQL ツールを使用してバックアップファイルを作成するため、他の PostgreSQL インストールへのエクスポートがきわめて簡単になります。 結果のバックアップファイルでは pg_dump​ のカスタム形式オプションが使用されます。プレーンテキスト形式と比較して、カスタム形式オプションでは、はるかに小さいバックアップファイルが生成されます。

一般に、PGBackups は、適度な負荷がかかった最大 20 GB までのデータベースを対象にしています。より大規模なデータベースをバックアップするために必要な I/O、メモリ、CPU の競合は適度な負荷でもきわめて激しくなり、実行時間が長くなると、バックアップの取得を早い段階で終了させるエラーが発生する可能性が高くなります。20 GB より大規模なデータベースには、物理バックアップと継続的保護​が推奨されます。

バックアップのダウンロード

Heroku Postgres データベースからデータをエクスポートするには、新しいバックアップを作成してダウンロードします。

$ heroku pg:backups:capture
$ heroku pg:backups:download

ローカルデータベースへの復元

pg_restore​ ツールを使用して、ローカルデータベースにダンプをロードします。 データベースのローカルコピーにすでにオブジェクトが存在する場合は、pg_restore​ を実行すると不整合が発生する可能性があります。

$ pg_restore --verbose --clean --no-acl --no-owner -h localhost -U myuser -d mydb latest.dump

インポート

PG バックアップは、他のソースから Heroku Postgres データベースにデータベースダンプをインポートするための便利なツールとして使用できます。

ダンプファイルの作成

オープンソースの pg_dump​ ツールを使用して、ローカルデータベースを圧縮された形式でダンプします。

$ PGPASSWORD=mypassword pg_dump -Fc --no-acl --no-owner -h localhost -U myuser mydb > mydb.dump

Heroku Postgres へのインポート

PG バックアップでダンプファイルにアクセスしてインポートするには、それを HTTP でアクセス可能な URL の場所にアップロードする必要があります。 署名済みの URL​ で Amazon S3 を使用することをお勧めします​。

AWS コンソールを使用して、署名済みの URL を生成します。

$ aws s3 presign s3://your-bucket-address/your-object

pg:backups restore​ コマンドで、生ファイルの URL を使用します。

$ heroku pg:backups:restore '<SIGNED URL>' DATABASE_URL

DATABASE_URL​ は、復元先のデータベースの HEROKU_POSTGRESQL_COLOR_URL​ を表します。データベースを復元するためのデータベース環境設定を指定する必要があります。

UNIX 系のオペレーティングシステムを使用している場合は、シェルを混乱させるアンパサンドなどの文字が含まれている可能性があるため、一時的な S3 URL の前後に一重引用符を使用するようにしてください。Windows を実行している場合は、二重引用符を使用する必要があります。

インポートプロセスが完了したら、ダンプファイルをその保存場所から削除します (不要な場合)。