最終更新日 2023年04月20日(木)

データのバックアップは、どのアプリケーションにとってもきわめて重要です。Standard 層以上のすべての Heroku Postgres データベースには、背後で自動的に実行され、障害復旧のための物理バックアップを取得する継続的保護​のメカニズムが組み込まれています。

テスト、環境の設定、データの移行に関しては、論理バックアップの方が物理バックアップよりも可搬性があります。Heroku Postgres の PGBackups 機能では、手動およびスケジュールで論理バックアップを実行できます。これらのバックアップは圧縮バイナリ形式​であり、ディスク上のデータベースの実際のサイズよりもずっと小さなサイズです。

この記事では、手動およびスケジュールで論理バックアップを実行する方法、既存のバックアップの表示方法、バックアップの復元方法、2 つのデータベース間で直接データを転送する方法について説明します。

手動バックアップ

手動バックアップを作成する

デフォルトでは、pg:backups​ は、DATABASE_URL​ 環境設定で指定されたプライマリデータベースに対して動作します。

$ heroku pg:backups:capture --app example-app
Hit Ctrl-C at any time to stop watching progress; the backup will
continue running. Stop a running backup with heroku pg:backups:cancel.

HEROKU_POSTGRESQL_BLACK (DATABASE_URL)  ----backup--->  b251

Running... done

あるいは、pg:backups:capture​ コマンドを実行し、取得する必要があるデータベースアドオンの名前を指定することもできます。

USAGE
  $ heroku pg:backups:capture [ADDON]

OPTIONS
  -a, --app=app  (required) app to run command against

EXAMPLE
  $ heroku pg:backups:capture postgresql-sinuous-83720 --app example-app

別のデータベースで手動バックアップを作成する

アプリケーションに複数のデータベースがある場合は、データベース名を指定して、どちらのバックアップを作成するかを選択します。

$ heroku pg:backups:capture HEROKU_POSTGRESQL_PINK
Hit Ctrl-C at any time to stop watching progress; the backup will
continue running. Stop a running backup with heroku pg:backups:cancel.

HEROKU_POSTGRESQL_PINK  ----backup--->  b252

Running... done

--verbose​ フラグを使用すると、バックアップの進行中にログが表示されます。

手動バックアップの作成をキャンセルする

バックアップを停止するには、cancel​ コマンドを使用します。

$ heroku pg:backups:cancel

Canceled backup b252

手動バックアップの保持制限

データベースプランによっては、保持できる手動バックアップの数に制限があります。

上記の制限に達し、さらにバックアップを作成する場合は、capture コマンドによってもっとも古い手動バックアップが自動的に削除され、その後、新しい手動バックアップが作成されます。

スケジュール設定されたバックアップ

手動で起動するバックアップに加え、定期的な自動バックアップのスケジュールを設定することができます。これらのバックアップは、毎日、指定したデータベースに対して実行されます。

バックアップスケジュールを設定する

$ heroku pg:backups:schedule DATABASE_URL --at '02:00 America/Los_Angeles' --app example-app

--at​ オプションでは、24 時間形式を使用して、バックアップを取る時刻を指定します。このオプションには、完全な TZ 形式 (America/Los_Angeles) または省略形 (PST) のいずれかでタイムゾーンを指定できますが、完全な TZ 形式 を使用することをお勧めします。

次の場合、バックアップスケジュールが失われる可能性があります。

• データベースを Essential 層プラン​から別の層のプランにアップグレードした。
• バックアップが新しいデータベースに復元された。
• フォロワーの切り替え​を使用して Heroku Postgres プランを更新した。元のデータベースのスケジュールは元のデータベースに関連付けられたままです。プロモートされたデータベースのスケジュールが存在しない場合は、スケジュールを作成する必要があります。

スケジュール設定されたバックアップを停止する

定期バックアップを停止するには、unschedule​ を使用します。

$ heroku pg:backups:unschedule DATABASE_URL --app example-app

バックアップスケジュールを表示する

アプリの現在のスケジュールを表示するには、schedules​ を使用します。

$ heroku pg:backups:schedules --app example-app
Current backup schedules:
RED: daily at 2:00 (America/Los_Angeles)

スケジュール設定されたバックアップの保持制限

スケジュール設定されたバックアップには、手動バックアップとは異なる保持ポリシーがあります。このポリシーは、データベースプランにも基づきます。

• 日次バックアップは、毎日、スケジュール設定された時刻​に取得されます。直近 7 日分の日次バックアップが保持されます。つまり、7 件 (直近 7 日間について 1 日 1 件) のバックアップが存在することになります。
• 週次バックアップとは、7 日ごとに 1 件のバックアップが保存されることを意味します。たとえば、Standard-4 データベースでは、4 件の週次バックアップ (直近 4 週間で毎週 1 件) が保持されます。
• 月次バックアップとは、1 か月間に 1 件のバックアップが保存されることを意味します。たとえば、Premium-0 データベースでは、12 件の月次バックアップ (直近 12 か月間で毎月 1 件) が保持されます。

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

URL 経由でダウンロード

pg:backups:url​ コマンドを使用して、公開バックアップ URL を作成できます。この URL は、Heroku Postgres の外部にデータをエクスポートするために役立ちます。バックアップ ID なしでコマンドを指定すると、最新の使用可能なバックアップ URL が返されます。

$ heroku pg:backups:url b001 --app example-app
The following URL will expire at 2015-04-07 18:35:50 +0000:
"http://s3.amazonaws.com/xkpgbackups/app1234567@heroku.com/b004.dump?AWSAccessKeyId=ABCD1234&Expires=1289261668&Signature=3mMBeKISewgEUDT%2FL5mRz4EYS4M%3D"

pg:backups:url​ コマンドでは、URL が期限切れになる時間が URL と共に出力されます。URL を他のコマンドに渡す場合は、pg:backups:url​ で期限情報が出力に追加されないようにして、後続のコマンドに URL だけが渡されるようにします。たとえば、追加情報なしで URL の一覧をターミナルに表示する場合は、次のようにします。

$ heroku pg:backups:url --app example-app | cat
http://s3.amazonaws.com/xkpgbackups/app1234567@heroku.com/b004.dump?AWSAccessKeyId=ABCD1234&Expires=1289261668&Signature=3mMBeKISewgEUDT%2FL5mRz4EYS4M%3D

コマンドライン経由でダウンロード

コマンドライン経由でバックアップをダウンロードするには、download​ コマンドを使用します。

$ heroku pg:backups:download

バックアップの状態と情報を確認する

バックアップとその状態の一覧を表示するには、次のコマンドを実行します。

$ heroku pg:backups --app example-app
=== Backups
ID    Backup Time                Status                              Size    Database
----  -------------------------  ----------------------------------  ------  --------
b013  2015-03-18 19:03:16 +0000  Running                                     IVORY
b011  2015-02-18 17:55:38 +0000  Finished 2015-02-18 17:55:39 +0000  1.9GB   IVORY
b010  2015-02-17 19:14:43 +0000  Finished 2015-02-17 19:14:48 +0000  1.9GB   IVORY
b004  2015-02-11 19:00:55 +0000  Finished 2015-02-17 19:14:48 +0000  1.9GB   IVORY

==== Restores
ID    Restore Time               Status                              Size    Database
----  -------------------------  ----------------------------------  ------  --------
r002  2015-03-16 17:33:19 +0000  Finished 2015-03-16 17:33:19 +0000  1.9GB   IVORY
r001  2015-03-15 12:13:44 +0000  Failed 2015-03-15 12:13:47 +0000    1.7GB   IVORY

特定のバックアップに関する詳細を表示するには、info​ コマンドを使用します。

$ heroku pg:backups:info b017 --app example-app
=== Backup info: b017
Database: HEROKU_POSTGRESQL_IVORY
Started:  2013-06-24 17:11.28 UTC
Status:   Running
Type:     Manual
Size:     1.2GB
Schema:   0bff3ac

オプションの --verbose​ フラグを使用して、バックアップのログを表示することもできます。バックアップがまだ実行中の場合は、バックアップが終了するまで、または CTRL+C​ を入力してコマンドをキャンセルするまで、進行中のログが出力されます。

バックアップを削除する

古くなったバックアップを削除したり、新しいバックアップ用の空き領域を確保したりするために、手動でバックアップを削除できます。バックアップ ID を使用して、削除するバックアップを指定します。

$ heroku pg:backups:delete b101 --app foo
Deleting b101... done

バックアップを復元する

バックアップを復元するには、restore​ コマンドを使用します。

$ heroku pg:backups:restore b101 DATABASE_URL --app example-app

このコマンドにより、バックアップ ID b101​ が、アプリ example-app​ で、指定されたデータベース URL に復元されます。注意: バックアップ ID とターゲットデータベースを省略して、最新のバックアップを DATABASE_URL​ に復元することができます。そうでない場合、バックアップ ID とターゲットデータベースの両方を指定する必要があります。

別のアプリのバックアップから復元することもできます (example-app​ から example-staging app​ へ)。

$ heroku pg:backups:restore example-app::b101 DATABASE_URL --app example-staging-app

公開 URL から復元することもできます。

$ heroku pg:backups:restore 'https://s3.amazonaws.com/me/items/mydb.dump' DATABASE_URL -a example-app

時間の経過と共に、テーブルの肥大化​や未使用のインデックスデータによって、ディスク上でデータベースが大きくなります。その結果、バックアップを新しいデータベースに復元すると、ほとんどの場合、pg:info​ で報告される全体ディスクサイズが減少します。

データベース間の直接コピー

pg:backups​ では、バックアップと復元に加え、データベース間で直接データを転送することもできます。

転送を実行するには、次のコマンドを実行します。

$ heroku pg:copy COBALT GREEN --app example-app

このコマンドにより、COBALT​ データベースから example-app​ アプリの GREEN​ データベースにすべてのデータがコピーされます。

別のアプリのデータベースから直接転送することもできます。たとえば、テストのために本番データをステージングアプリにコピーします。

$ heroku pg:copy example-app::HEROKU_POSTGRESQL_ORANGE_URL GREEN --app example-staging-app

このコマンドにより、example-app​ の HEROKU_POSTGRESQL_ORANGE​ データベースから example-staging-app​ の GREEN​ データベースにデータがコピーされます。

視認性

Heroku Postgres では、バックアップを取るために、ご使用の資格情報を使ってデータベースに接続する必要があります。この接続は、ご利用のプランの接続制限の件数に含まれます。ターミナルから次のコマンドを実行すると、Heroku Postgres によって行われた接続を識別できます。

$ heroku pg:psql -c "select * from pg_stat_activity where application_name = 'Heroku Postgres Backups'"

データの所在

pg:backups​ を使用して取得されたすべてのバックアップは、データベースのある場所にかかわらず米国内で保管されます​。

Heroku が利用しているサブプロセッサーの一覧と Heroku データが保存され、処理されている国の一覧については、「Salesforce Infrastructure & Sub-processors​」 (Salesforce のインフラストラクチャとサブプロセッサー) ドキュメントを参照してください。