PostgreSQL メジャーバージョンのアップグレードのテスト

この記事の英語版に更新があります。ご覧の翻訳には含まれていない変更点があるかもしれません。

最終更新日 2024年11月01日(金)

Heroku では、Heroku Postgres アドオンのための PostgreSQL メジャーバージョンのアップグレードをテストしてから、本番データベースでアップグレードを実行する​ことをお勧めします。

バージョンアップグレードをテストすることは、データベースまたはアプリケーションに影響を及ぼす可能性がある、考えられるすべてのアップグレードエラーや非互換性の問題を特定するのに役立ちます。テストを行うと、本番データベースをアップグレードするときにアプリケーションのダウンタイムを削減するのに役立ちます。

アップグレードの最も一般的な問題は、PostgreSQL バージョン間の型の非互換性やオブジェクトの参照または依存関係のエラーのほか、アプリまたはその PostgreSQL ドライバーのバージョンがターゲットの PostgreSQL バージョンをサポートしない場合の一般的なアプリケーションの問題に関するものです。

pg:upgrade による PostgreSQL バージョンアップグレードのテスト

pg:upgrade​ のメソッドは、非推奨の mini​ プランと basic​ プラン​を除くすべての Heroku Postgres データベースで推奨されています。

pg:upgrade​ で PostgreSQL のバージョンアップグレードを実行するには、約 30 分間のアプリのダウンタイムが必要になります。アップグレードに 30 分以上かかる場合は、サポートチケットを開いてください​。

アップグレードプロセスをテストするには、完全なアップグレードプロセスを実行して検証するために、非本番アプリ上で既存の本番データベースをフォークします​。

以下によって、ステージングアプリまたは非本番アプリ上に本番データベースのフォークが作成されます。

addons:create​ の例は Heroku CLI v9.0.0​ 以降の構文に従っています。v8.11.5 以前を使用している場合は、次のコマンドを使用してください。

$ heroku addons:create heroku-postgresql:​<database_plan>​ --fork production_app_name::DATABASE_URL --as PROD_DB_FORK -a staging_app_name

$ heroku addons:create heroku-postgresql:<database_plan> --as PROD_DB_FORK -a staging_app_name -- --fork production_app_name::DATABASE_URL

フォークされたデータベースの準備ができたら、バージョンアップグレードプロセス​を開始し、そのフォロワーを作成します。

addons:create​ の例は Heroku CLI v9.0.0​ 以降の構文に従っています。v8.11.5 以前を使用している場合は、次のコマンドを使用してください。

$ heroku addons:create heroku-postgresql:​<database_plan>​ --follow staging_app_name::PROD_DB_FORK --as TEST_UPGRADE_FOLLOWER --app staging_app_name

$ heroku addons:create heroku-postgresql:<database_plan> --as TEST_UPGRADE_FOLLOWER --app staging_app_name -- --follow staging_app_name::PROD_DB_FORK staging_app_name

テストフォロワーをアップグレードするには、この記事の手順に従います。データベースのバージョンアップグレードテストを実行するには、アップグレードされたデータベースを、非本番アプリケーションのプライマリデータベースとしてプロモートします。アプリケーションが期待どおりにデータベースと接続して通信できることを確認します。

$ heroku pg:promote TEST_UPGRADE_FOLLOWER --app staging_app_name

このアプローチにより、ユーザーは完全なアップグレードプロセスをテストし、本番環境でアップグレードするときにアップグレードの所要時間を見積もることができます。このプロセスは、(アプリケーションで古い PostgreSQL クライアントやドライバーを使用しない場合に) アプリケーションが新しい PG バージョンと互換性があることを確認するためにも役立ちます。

アップグレードのテストが完了したら、フォークされたデータベース​とアップグレードされたフォロワーを削除できます。

もう 1 つのテストアプローチ

バージョンアップグレードのテストプロセスをスピードアップするために、別のアプローチとして、非本番環境に本番アプリケーションのフォロワーを作成する方法があります。pg:upgrade​をフォロワーで直接実行できます。

アップグレードされたデータベースを非本番環境内でプライマリデータベースとしてプロモートし、アプリケーションに新しいバージョンとの互換性があることを確認します。

pg:copy による PostgreSQL バージョンアップグレードのテスト

pg:copy​ のメソッドを使用して、10 GB 以下の PostgreSQL バージョンのデータベースをアップグレードします。

pg:copy​ による PostgreSQL バージョンのアップグレードを実行するには、GB あたり約 3 分のダウンタイムが必要ですが、この量は大きく変動する場合があります。

アップグレードプロセスをテストするには、非本番アプリケーション上に新しいデータベースをプロビジョニングし、ターゲットの PostgreSQL バージョンを指定します。

addons:create​ の例は Heroku CLI v9.0.0​ 以降の構文に従っています。v8.11.5 以前を使用している場合は、次のコマンドを使用してください。

$ heroku addons:create heroku-postgresql:​<database_plan>​ --version=15 --as DATABASE_UPGRADE_TEST --app staging_app_name

$ heroku addons:create heroku-postgresql:<database_plan> --as DATABASE_UPGRADE_TEST --app staging_app_name -- --version=15

新しいデータベースが使用可能になったため、データを本番データベースから新しいデータベースにコピーします。

$ heroku pg:copy production_app_name::DATABASE_URL DATABASE_UPGRADE_TEST --app staging_app_name

データコピーが完了した後、データベースを非本番アプリケーションにプロモートし、アプリケーションが新しいバージョンと互換性があることを確認します。

$ heroku pg:promote DATABASE_UPGRADE_TEST --app staging_app_name

データコピープロセスが失敗した場合、heroku pg:backups:info <COPY_ID>​ で入手できるログでエラーの詳細を調べてください。