インプレースアップグレードの実行手順

メジャーバージョンの Aurora MySQL インプレースアップグレードの仕組み の背景のマテリアルを確認することをお勧めします。

「Aurora MySQL クラスターのメジャーバージョンアップグレードの計画」の説明に従い、アップグレード前の計画とテストを行います。

aws rds modify-db-cluster \
          --db-cluster-identifier sample-cluster \
          --engine-version 8.0.mysql_aurora.3.04.1 \
          --allow-major-version-upgrade \
          --apply-immediately

aws rds modify-db-cluster ^
          --db-cluster-identifier sample-cluster ^
          --engine-version 8.0.mysql_aurora.3.04.1 ^
          --allow-major-version-upgrade ^
          --apply-immediately

インプレースアップグレードはクラスターのパラメータグループにどのような影響を与えるか

Aurora パラメータグループには、異なる MySQL バージョンと互換性のあるクラスター向けに、異なる構成設定のセットがあります。インプレースアップグレードを実行する際、アップグレードされたクラスターとそのすべてのインスタンスで、新しいメジャーバージョンと互換性のある対応するクラスターおよびインスタンスのパラメータグループを使用する必要があります。

クラスターとインスタンスがソースバージョンのデフォルトのパラメータグループを使用する場合、アップグレードされたクラスターとインスタンスはターゲットバージョンのデフォルトのパラメータグループで自動的に開始されます。クラスターとインスタンスでカスタムパラメータグループを使用する場合は、ターゲットバージョンと互換性のある対応するパラメータグループを作成してください。また、アップグレード処理中に必ずそれらを指定してください。

次の表は、各アップグレードパスのデフォルトのパラメータグループのマッピングを示しています。

Aurora MySQL バージョン間のクラスターのプロパティの変更

メジャーバージョンアップグレードを実行する場合は、Aurora MySQL クラスターと DB インスタンスのセットアップと管理に使用するアプリケーションやスクリプトを確認してください。

また、デフォルトのパラメータグループ名がメジャーバージョンごとに異なることを考慮して、パラメータグループを操作するコードを変更します。

Aurora MySQL バージョン 2 からバージョン 3

例えば、アップグレード前にクラスターに適用される次のようなコードがあるとします。

# Check the default parameter values for MySQL 5.7–compatible clusters.
aws rds describe-db-parameters --db-parameter-group-name default.aurora-mysql5.7 --region us-east-1

クラスターのメジャーバージョンをアップグレードした後、そのコードを次のように変更します。

# Check the default parameter values for MySQL 8.0–compatible clusters.
aws rds describe-db-parameters --db-parameter-group-name default.aurora-mysql8.0 --region us-east-1

Aurora MySQL バージョン 3 からバージョン 8.4

同様に、バージョン 3 のデフォルトパラメータグループを参照するコードがある場合は、アップグレード後に更新します。

# Before upgrade: Check the default parameter values for MySQL 8.0–compatible clusters.
aws rds describe-db-parameters --db-parameter-group-name default.aurora-mysql8.0 --region us-east-1

# After upgrade: Check the default parameter values for MySQL 8.4–compatible clusters.
aws rds describe-db-parameters --db-parameter-group-name default.aurora-mysql8.4 --region us-east-1

グローバルデータベースのインプレースメジャーアップグレード

Aurora Global Database の場合は、グローバルデータベースクラスターをアップグレードします。Aurora は、すべてのクラスターを同時かつ自動的にアップグレードし、すべてのクラスターで、同じエンジンバージョンが実行されることを保証します。これは、システムテーブルやデータファイル形式などの変更が、すべてのセカンダリクラスターに自動的にレプリケートされるためです。

「メジャーバージョンの Aurora MySQL インプレースアップグレードの仕組み」の手順に従います。アップグレードする対象を指定するときは、そのデータベースに含まれるクラスターの 1 つではなく、グローバルデータベースクラスターを選択してください。

AWS マネジメントコンソール を使用する場合、[Global database] (グローバルデータベース) のロールを持つアイテムを選択します。

AWS CLI または RDS API を使用する場合は、modify-global-cluster コマンドまたは ModifyGlobalCluster オペレーションを呼び出して、アップグレードプロセスをスタートします。modify-db-cluster または ModifyDBCluster の代わりにこれらのいずれかを使用します。

AWS CLI を使用して Aurora MySQL グローバルデータベースクラスターのメジャーバージョンをアップグレードするには、以下の必須パラメータを指定して、modify-global-cluster コマンドを使用します。

次の例では、Global Database クラスターを Aurora MySQL バージョン 3.04.2 にアップグレードします。

aws rds modify-global-cluster \
          --global-cluster-identifier global_cluster_identifier \
          --engine aurora-mysql \
          --engine-version 8.0.mysql_aurora.3.04.2 \
          --allow-major-version-upgrade

aws rds modify-global-cluster ^
          --global-cluster-identifier global_cluster_identifier ^
          --engine aurora-mysql ^
          --engine-version 8.0.mysql_aurora.3.04.2 ^
          --allow-major-version-upgrade

クロスリージョンリードレプリカを持つ DB クラスターのインプレースアップグレード

クロスリージョンリードレプリカを持つ Aurora DB クラスターは、インプレースアップグレード手順を使用してアップグレードできますが、いくつかの考慮事項があります。