Amazon RDS の PostgreSQL DB エンジンのアップグレード

バージョンとの互換性を持つパラメータグループの準備 – カスタムパラメータグループを使用している場合は、2 つのオプションがあります。新しい DB エンジンバージョンのデフォルトのパラメータグループを指定します。または、新しい DB エンジンバージョンの独自のカスタムパラメータグループを作成します。

新しいパラメータグループを DB インスタンスに関連付ける場合は、アップグレードの完了後にデータベースを再起動します。パラメータグループの変更を適用するためにインスタンスを再起動する必要がある場合、インスタンスのパラメータグループのステータスは pending-reboot と表示されます。インスタンスのパラメータグループのステータスをコンソールで表示するには、describe コマンド (例: describe-db-instances) を使用します。

サポートされていない DB インスタンスクラスを確認する – データベースのインスタンスクラスが、アップグレード先の PostgreSQL バージョンと互換性があることを確認します。詳細については、「DB インスタンスクラスでサポートされている DB エンジン」を参照してください。

サポートされていない使用の確認

リードレプリカの処理 – アップグレードでは、プライマリインスタンスと共にリージョン内リードレプリカもアップグレードされます。

リードレプリカを個別にアップグレードすることはできません。個別にアップグレードできるとすると、プライマリインスタンスとレプリカインスタンスの PostgreSQL メジャーバージョンが一致しないという状況が生じる可能性があります。ただし、レプリカをアップグレードすると、プライマリインスタンスのダウンタイムが増加する場合があります。レプリカのアップグレードを防ぐには、レプリカをスタンドアロンインスタンスに昇格させるか、アップグレードプロセスを開始する前にレプリカを削除します。

アップグレードプロセスでは、レプリカインスタンスの現在のパラメータグループに基づいて、レプリカのパラメータグループが再作成されます。アップグレードの完了後にのみ、modify-db-parameter-group CLI コマンドを使用してカスタムパラメータグループをレプリカに適用できます。

Virtual Private Cloud (VPC) プラットフォームのリードレプリカはアップグレードされますが、EC2-Classic プラットフォームのレプリカはアップグレードされません。EC2-Classic レプリカは、アップグレードプロセスが完了しても、レプリケーション終了状態のままになります。DB インスタンスを EC2-Classic プラットフォームから VPC に移動するには、「VPC 外の DB インスタンスを VPC 内に移行する」を参照してください。詳細については、「Amazon RDS での PostgreSQL リードレプリカの使用」を参照してください。

バックアップの実行 – データベースの復元ポイントを認識できるように、メジャーバージョンアップグレードを実行する前にはバックアップを実行しておくことをお勧めします。バックアップ保持期間を 0 より大きい値に設定すると、アップグレードプロセスにおいて、アップグレード前後に DB インスタンスの DB スナップショットが作成されます。バックアップ保持期間を変更するには、「Amazon RDS DB インスタンスを変更する」を参照してください。手動でバックアップを実行するには、「DB スナップショットの作成」を参照してください。

メジャーバージョンのアップグレード前に特定の拡張機能を更新する – アップグレードでメジャーバージョンをスキップする場合、メジャーバージョンのアップグレード前に特定の拡張機能を更新する必要があります。バージョン 9.5.x または 9.6.x からバージョン 11.x 以降へのアップグレードでは、メジャーバージョンがスキップされます。更新する拡張機能は以下のとおりです。

使用している拡張機能ごとに次のコマンドを実行します。

ALTER EXTENSION PostgreSQL-extension UPDATE TO 'new-version'

詳細については、「PostgreSQL の拡張機能のアップグレード」を参照してください。

メジャーバージョンのアップグレード前の特定の拡張機能の削除 – メジャーバージョンをバージョン 11.x にスキップするアップグレードは、pgRouting 拡張機能の更新をサポートしていません。バージョン 9.4.x、9.5.x、または 9.6.x からバージョン 11.x へのアップグレードでは、メジャーバージョンがスキップされます。pgRouting 拡張機能を削除し、アップグレード後に互換性のあるバージョンに再インストールできます。更新できる拡張機能のバージョンについては、Amazon RDS でサポートされる PostgreSQL の拡張機能 をご覧ください。

tsearch2 および chkpass の拡張機能は、PostgreSQL バージョン 11 以降では現在サポートされていません。バージョン 11.x にアップグレードする場合は、アップグレードの前に、tsearch2 および chkpass 拡張機能を削除します。

unknown データ型の削除 – ターゲットのバージョンに応じて、unknown データ型を削除します。

PostgreSQL バージョン 10 では、unknown データ型のサポートは終了しています。バージョン 9.6 のデータベースで unknown データ型を使用している場合、バージョン 10 にアップグレードすると次のようなエラーメッセージが表示されます。

Database instance is in a state that cannot be upgraded: PreUpgrade checks failed: 
The instance could not be upgraded because the 'unknown' data type is used in user tables. 
Please remove all usages of the 'unknown' data type and try again."

データベース内の unknown データ型を検索して、問題の列を削除したり、サポートされているデータ型に変更したりするには、次の SQL を使用します。

SELECT DISTINCT data_type FROM information_schema.columns WHERE data_type ILIKE 'unknown';

リハーサル更新の実行 – プロダクションデータベースのアップグレードを行う前に、プロダクションデータベースの複製でメジャーバージョンアップグレードをテストすることを強くお勧めします。テストインスタンスの複製を作成するには、データベースを最新スナップショットから復元するか、ポイントインタイムの復元を実行して復元可能な直近の時間でデータベースを復元します。詳細については、「スナップショットからの復元」または「特定の時点への DB instanceの復元」を参照してください。アップグレードの実施の詳細については、「エンジンバージョンの手動アップグレード」を参照してください。

メジャーバージョンのアップグレード中、public データベースと template1 データベース、およびインスタンスのすべてのデータベースの public スキーマは、一時的に名前が変更されます。これらのオブジェクトは、元の名前とランダム文字列を組み合わせた名前でログに表示されます。この文字列は、メジャーバージョンアップグレード時に locale や owner などのカスタム設定が保持されるように追加されます。アップグレードが完了したら、これらのオブジェクト名は元の名前に戻ります。

事前チェック手順エラーでアップグレードが失敗した場合、問題を解決します – メジャーバージョンのアップグレードプロセス中に、Amazon RDS の PostgreSQL は最初に事前チェック手順を実行して、アップグレードの失敗の原因となる可能性のある問題を特定します。事前チェック手順は、インスタンス内のすべてのデータベースにわたって潜在的な互換性のない条件をすべてチェックします。

事前チェックで問題が発生した場合、アップグレード事前チェックが失敗したことを示すログイベントが作成されます。事前確認プロセスの詳細は、DB インスタンスのすべてのデータベースの pg_upgrade_precheck.log と名前が付けられたアップグレードログにあります。Amazon RDS では、ファイル名にタイムスタンプが追加されます。ログの表示の詳細については、「Amazon RDS データベースログファイルの操作」を参照してください。

レプリカのアップグレードが事前チェックで失敗した場合、失敗したレプリカのレプリケーションは中断され、レプリカは終了状態になります。レプリカを削除し、アップグレードしたプライマリインスタンスに基づいて、新しいレプリカを再作成します。

事前チェックログで特定されたすべての問題を解決してから、メジャーバージョンのアップグレードを再試行します。事前チェックログの例は次のようになります。

------------------------------------------------------------------------
Upgrade could not be run on Wed Apr 4 18:30:52 2018
-------------------------------------------------------------------------
The instance could not be upgraded from 9.6.11 to 10.6 for the following reasons.
Please take appropriate action on databases that have usage incompatible with the requested major engine version upgrade and try the upgrade again.

* There are uncommitted prepared transactions. Please commit or rollback all prepared transactions.* One or more role names start with 'pg_'. Rename all role names that start with 'pg_'.

* The following issues in the database 'my"million$"db' need to be corrected before upgrading:** The ["line","reg*"] data types are used in user tables. Remove all usage of these data types.
** The database name contains characters that are not supported by RDS for PostgreSQL. Rename the database.
** The database has extensions installed that are not supported on the target database version. Drop the following extensions from your database: ["tsearch2"].

* The following issues in the database 'mydb' need to be corrected before upgrading:** The database has views or materialized views that depend on 'pg_stat_activity'. Drop the views.

データベースのアップグレード中にレプリカのアップグレードが失敗した場合は、問題を解決します – 失敗したレプリカは incompatible-restore 状態になり、レプリケーションは DB インスタンスで終了します。レプリカを削除し、アップグレードしたプライマリインスタンスに基づいて、新しいレプリカを再作成します。

レプリカのアップグレードは、次の理由で失敗することがあります。

本番稼働用インスタンスのアップグレード – リハーサルのメジャーバージョンアップグレードに成功すれば、自信を持って本番稼働用のプロダクションデータベースをアップグレードできます。詳細については、「エンジンバージョンの手動アップグレード」を参照してください。