Heroku Postgres ロールバック

最終更新日 2019年10月09日(水)

Heroku Postgres ロールバックを使用すると、heroku releases:rollback​ でアプリケーションの古いデプロイにロールバックできる方法と同様に、 データベースの状態を以前の時点に “ロールバック” できます。

ロールバックは、プライマリデータベースには影響を与えず、代わりにフォーク​と同じパターンに従います。 つまり、どのような方法でもプライマリに直接接続されていない新しいデータベースがプロビジョニングされます。フォークと同様に、ロールバックも使用可能になるまでにしばらく時間がかかります。

使用可能なロールバック期間は、データベースプラン​によって異なります。

プライマリでデータベースの資格情報がリセットされている場合、ロールバックは引き続き、資格情報のリセットより前の時点までさかのぼってサポートされます。ロールバックプロセス中にフォークが作成されると、新しい一連の資格情報が作成されます。

ロールバックデータベースの作成

ロールバックする前に、データベースで目的のロールバックポイントが使用可能であることを確認する必要があります。ロールバックの可用性は、データベースプランによって異なります。現在のデータベースのロールバックの可用性を確認するには、heroku pg:info​ コマンドを使用します。

$ heroku pg:info --app sushi
=== HEROKU_POSTGRESQL_YELLOW_URL (DATABASE_URL)
Plan:        Standard 0
Status:      Available
Data Size:   584.6 MB
Tables:      29
PG Version:  9.2.4
Connections: 8
Fork/Follow: Available
Rollback:    from 2013-10-18 20:00 UTC
Created:     2013-04-18 20:14 UTC
Maintenance: not required

ロールバックは、フォーキング後一定期間の新しいフォークに対しても、 フォロー解除後一定期間のフォロワーに対しても使用できません。

ロールバックデータベースの作成では、フォロワー​の作成と同じメカニズムが使用されます。プロビジョニングは、--rollback​ フラグを使用した新しいデータベースアドオンの作成時に実行されます。--rollback​ フラグは、同じアプリ上のデータベースの環境設定名、フォーム appname::HEROKU_POSTGRESQL_COLOR​ の引数、または任意の Heroku Postgres データベースのフル URL を受け取ることができます。

さらに、ロールバック先の時刻を指定する必要があります。目的の時刻を示す方法には、明示的なタイムスタンプまたは相対的な時間間隔の 2 つがあります。明示的なタイムスタンプは、タイムゾーンのオフセットを含む 2013-10-22 12:34+00:00​ の形式にする必要があります。また、シンボリックタイムゾーンを使用することもできます。たとえば、2013-10-22 12:34 US/Pacific​ とします。間隔は 3 days 7 hours 22 minutes​ の形式にする必要があります。リカバリ時間は --to​ フラグを使用して、リカバリ間隔は --by​ を使用して渡す必要があります。両方ではなく、どちらかが存在する必要があります。ロールバックは、秒単位まで正確ではありません。リカバリ時間または間隔で指定された秒数は無視されます。

完全なロールバックコマンドは次のようになります。

$ heroku addons:create heroku-postgresql:standard-0 --rollback HEROKU_POSTGRESQL_YELLOW --to '2013-10-21 15:52+00' --app sushi

ターゲットのリカバリ時間 (および、これが今からどれくらい前であるか) がプロビジョニングコマンドの出力でエコーされます。

ロールバックの準備には、データセットのサイズに応じて、数分から数時間かかることがあります。heroku pg:wait​ コマンドでは、 すべての新しいデータベースのプロビジョニングステータスが表示されるため、これを使用してロールバックがいつ最新になるかを判定できます。

$ heroku pg:wait --app sushi
Waiting for database HEROKU_POSTGRESQL_SILVER_URL... available

プロビジョニング解除

ロールバックが完了したら、heroku addons:destroy​ を使用してそれをプロビジョニング解除します。

このコマンドで必ず _URL​ サフィックスをデータベース名から除去してください。

$ heroku addons:destroy HEROKU_POSTGRESQL_YELLOW --app sushi
    !    WARNING: Destructive Action
    !    This command will affect the app: sushi
    !    To proceed, type "sushi" or re-run this command with --confirm sushi

一般的なユースケース: 重大なデータ損失の後のリカバリ

ロールバックは、重要なテーブルを誤って削除するなど、重大なデータ損失の問題が発生した場合に最適な安全策です。 ロールバックを使用して失ったデータを復旧するには、次のようにします。

  1. ロールバックを作成します。

    $ heroku addons:create heroku-postgresql:standard-0 --rollback HEROKU_POSTGRESQL_YELLOW --to '2013-10-21 15:52+00' --app sushi
Creating heroku-postgresql:standard-0 on ⬢ sushi... $50/month
Database will become available after it completes rolling back
to 2013-10-21 15:52+0000.
Use `heroku pg:wait` to track status.
postgresql-adjacent-88888 is being created in the background. The app will restart when complete...
Use heroku addons:info postgresql-adjacent-88888 to check creation progress
Use heroku addons:docs heroku-postgresql to view documentation

  2. ロールバックが最新であることを確認します。

    $ heroku pg:wait --app sushi
Waiting for database HEROKU_POSTGRESQL_SILVER... available

  3. ロールバックをプライマリデータベースとしてプロモート​します。

    $ heroku pg:promote HEROKU_POSTGRESQL_SILVER --app sushi

  4. すべてのフォロワー​上の複製を新しいリーダーに対して再確立します (該当する場合)。

    $ heroku addons:create heroku-postgresql:standard-2 --follow HEROKU_POSTGRESQL_SILVER --app sushi
Adding heroku-postgresql:standard-2 to sushi... done, v71 ($200/mo)
Attached as HEROKU_POSTGRESQL_WHITE
Follower will become available for read-only queries when up-to-date
Use `heroku pg:wait` to track status