インプレースアップグレードはクラスターのパラメータグループにどのような影響を与えるか Aurora MySQL バージョン間のクラスターのプロパティの変更グローバルデータベースのインプレースメジャーアップグレード

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

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

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

次の例では、mydbcluster-cluster DB クラスターを Aurora MySQL バージョン 3.04.1 にアップグレードします。

Aurora MySQL DB クラスターのメジャーバージョンをアップグレードするには

AWS Management Console にサインインし、Amazon RDS コンソール https://console.aws.amazon.com/rds/ を開きます。
元の DB クラスターでカスタムパラメータグループを使用した場合は、新しいメジャーバージョン互換のパラメータグループを作成します。新しいパラメータグループの設定パラメータに必要な調整を行います。詳細については、「インプレースアップグレードはクラスターのパラメータグループにどのような影響を与えるか」を参照してください。
ナビゲーションペインで、[データベース] を選択します。
リストから、変更する DB クラスターを選択します。
Modify を選択します。
[Version] (バージョン) で、新しい Aurora MySQL のメジャーバージョンを選択します。

通常、メジャーバージョンの最新のマイナーバージョンを使用することをお勧めします。ここでは、現在のデフォルトバージョンを選択します。
[Continue] (続行) をクリックします。
次のページで、アップグレードを実行するタイミングを指定します。[次の定期メンテナンス期間中] または [今すぐ] を選択します。
(オプション) アップグレード中、RDS コンソールの [イベント] ページを定期的に確認します。これにより、アップグレードの進行状況をモニタリングし、問題を特定することができます。アップグレードで問題が発生した場合は、Aurora MySQL インプレースアップグレードのトラブルシューティングを参照してステップを実行してください。
この手順のスタート時に、新しいパラメータグループを作成した場合は、アップグレードしたクラスターにカスタムパラメータグループを関連付けます。詳細については、「インプレースアップグレードはクラスターのパラメータグループにどのような影響を与えるか」を参照してください。

注記
このステップを実行するには、クラスターを再起動して新しいパラメータグループを適用する必要があります。
(オプション) アップグレード後のテストが完了したら、アップグレードのスタート時に Aurora によって作成された手動スナップショットを削除します。

Aurora MySQL DB クラスターのメジャーバージョンをアップグレードするには、次の必須パラメータを指定しながら、AWS CLI の modify-db-cluster コマンドを実行します。

--db-cluster-identifier
--engine-version
--allow-major-version-upgrade
--apply-immediately または --no-apply-immediately

クラスターでカスタムパラメータグループを使用する場合は、次のオプションの 1 つ、または両方を含めます。

--db-cluster-parameter-group-name、クラスターがカスタムクラスターのパラメータグループを使用している場合
--db-instance-parameter-group-name、クラスター内のインスタンスがカスタム DB のパラメータグループを使用している場合

次の例では、sample-cluster DB クラスターを Aurora MySQL バージョン 3.04.1 にアップグレードします。アップグレードは、次のメンテナンスウィンドウを待つことなく、すぐに実行されます。

例

Linux、macOS、Unix の場合:


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

Windows の場合:


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

他の CLI modify-db-cluster コマンドをと組み合わせて、アップグレードを実行および検証するための自動化されたエンドツーエンドのプロセスを作成できます。詳細な説明と例については、「Aurora MySQL インプレースアップグレードのチュートリアル」を参照してください。

注記

クラスターが Aurora Global Database の一部である場合、インプレースアップグレードの手順は若干異なります。modify-db-cluster の代わりに、modify-global-cluster コマンドオペレーションを呼び出します。詳細については、「グローバルデータベースのインプレースメジャーアップグレード」を参照してください。

Aurora MySQL DB クラスターのメジャーバージョンをアップグレードするには、次の必須パラメータを指定して RDS API の ModifyDBCluster オペレーションを使用します。

DBClusterIdentifier
Engine
EngineVersion
AllowMajorVersionUpgrade
ApplyImmediately (true、または false に設定)

注記

クラスターが Aurora Global Database の一部である場合、インプレースアップグレードの手順は若干異なります。 ModifyDBCluster の代わりに、 modifyGlobalCluster オペレーションを呼び出します。詳細については、「グローバルデータベースのインプレースメジャーアップグレード」を参照してください。

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

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

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

注記

ほとんどのパラメータ設定では、2 つのポイントでカスタムパラメータグループを選択できます。これらは、クラスターの作成時や、パラメータグループをクラスターに関連付ける場合です。

ただし、デフォルト以外の設定を lower_case_table_names パラメータに使用する場合は、事前にこの設定を使用してカスタムパラメータグループを設定する必要があります。その後、スナップショット復元を実行してクラスターを作成する際、パラメータグループを指定します。クラスター作成後のlower_case_table_names パラメータへの変更は、影響がありません。

Aurora MySQL バージョン 2 からバージョン 3 にアップグレードする場合にも、同じ lower_case_table_names の設定を使用することをお勧めします。

Aurora MySQL に基づく Aurora グローバルデータベースでは、lower_case_table_names パラメータがオンの場合、Aurora MySQL バージョン 2 からバージョン 3 へのインプレースアップグレードを実行できません。使用できる方法の詳細については、「メジャーバージョンのアップグレード」を参照してください。

重要

アップグレードプロセス中にカスタムパラメータグループを指定した場合は、アップグレード終了後にクラスターを手動で再起動してください。再起動すると、クラスターがカスタムパラメータ設定の使用をスタートできます。

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

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

また、5.7 および 8.0 互換クラスターではデフォルトのパラメータグループ名が異なることを考慮して、パラメータグループを操作するコードを変更します。Aurora MySQL バージョン 2 と 3 のクラスターのデフォルトのパラメータグループ名は、それぞれ default.aurora-mysql5.7 と default.aurora-mysql8.0 です。

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


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

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

AWS Management Console を使用する場合、[Global database] (グローバルデータベース) のロールを持つアイテムを選択します。

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

注記

Aurora グローバルデータベースのメジャーバージョンアップグレードを実行している間、グローバルデータベースクラスターのカスタムパラメータグループを指定することはできません。グローバルクラスターの各リージョンにカスタムパラメータグループを作成します。次に、アップグレード後に手動でリージョンクラスターに適用します。

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

--global-cluster-identifier
--engine aurora-mysql
--engine-version
--allow-major-version-upgrade

次の例では、グローバルデータベースクラスターを Aurora MySQL バージョン 2.10.2 にアップグレードします。

例

Linux、macOS、Unix の場合:


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

Windows の場合:


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

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

Aurora MySQL の事前チェックの説明リファレンス

Aurora MySQL インプレースアップグレードのチュートリアル