Heroku Postgres データベースのインポートとエクスポート
この記事の英語版に更新があります。ご覧の翻訳には含まれていない変更点があるかもしれません。
最終更新日 2020年01月23日(木)
表面上、PG バックアップは、Heroku Postgres データベースの定期バックアップを取得するための方法を提供します。ただし、その汎用アーキテクチャおよび標準の PostgreSQL ユーティリティの使用のため、これは外部の PostgreSQL データベースとの間のエクスポートやインポートを実行できる有効なツールにもなっています。
ローカルマシン上に Postgres インスタンスがある場合にインポート/エクスポートのダンプおよび復元方法を使用する代替法として、pg:push と pg:pull の CLI コマンドを使用したプロセスの自動化があります。
エクスポート
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 を実行すると不整合が発生する可能性があります。
これにより通常、Heroku データベースとローカルデータベースの違いが原因で警告が表示されますが、これらは一般に無視しても問題ありません。
$ pg_restore --verbose --clean --no-acl --no-owner -h localhost -U myuser -d mydb latest.dump
古いバージョンの pg_restore を使用している場合は、pg_restore を実行しようとすると、pg_restore: [archiver] unsupported version (1.13) in file header などのエラーが表示されることがあります。pg_restore バージョン 11、10.3、9.6.8、9.5.12、9.4.17、9.3.22 以上を使用していることを確認してください。pg_restore のバージョンは、pg_restore --version を実行することによって確認できます。
pg_restore でオプションで --jobs <number of jobs> フラグを使用すると、ダンプの復元を並列化できます。このオプションでは、カスタムおよびディレクトリアーカイブ形式のみがサポートされています。これについての詳細は、Postgres のドキュメントを参照してください。
インポート
PG バックアップは、他のソースから Heroku Postgres データベースにデータベースダンプをインポートするための便利なツールとして使用できます。
新しいアプリケーションの初期化の一部としてデータをインポートする場合は、インポートを実行する前に、まず Heroku でアプリを作成して設定する必要があります。
ダンプファイルの作成
オープンソースの 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 を使用することをお勧めします。
pg:backups restore コマンドでは、テーブルやその他のデータベースオブジェクトのすべてが再作成の前に削除されることに注意してください。
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 を実行している場合は、二重引用符を使用する必要があります。
インポートプロセスが完了したら、ダンプファイルをその保存場所から削除します (不要な場合)。