AWS CloudFormation テンプレートを使用して Neptune DB クラスターのエンジンバージョンを更新する

Neptune DB クラスターの作成に使用した Neptune AWS CloudFormation テンプレートを再利用して、エンジンバージョンを更新できます。

Neptune エンジンバージョンのアップグレードは、マイナーとメジャーがあります。 AWS CloudFormation テンプレートを使用すると、多くの場合大幅な変更を含むメジャーバージョンのアップグレードに役立ちます。メジャーバージョンアップグレードには、既存のアプリケーションとの下位互換性のないデータベースの変更が含まれる場合があるため、アップグレード時にアプリケーションに変更を加える必要がある場合もあります。必ず、アップグレードの前にテストしてください。また、アップグレードの前に、DB クラスターの手動スナップショットを常に作成することを強くお勧めします。

メジャーバージョンごとに個別のエンジンアップグレードを行う必要があることに注意してください。メジャーバージョンをスキップして、次のメジャーバージョンに直接アップグレードすることはできません。

2023 年 5 月 17 日より前に Neptune AWS CloudFormation スタックを使用してエンジンバージョンをアップグレードした場合、現在の DB クラスターの代わりに新しい空の DB クラスターが作成されました。ただし、2023 年 5 月 17 日現在、Neptune AWS CloudFormation スタックは既存のデータを保持するインプレースエンジンアップグレードをサポートするようになりました。

メジャーバージョンアップグレードの場合、テンプレートで DBCluster に次のプロパティを設定する必要があります。

同様に、DBCluster にアタッチされた DBInstance に対しても以下を設定する必要があります。

デフォルトかカスタムかにかかわらず、すべてのパラメータグループがテンプレートで定義されていることを確認してください。

カスタムパラメータグループの場合は、既存のカスタムパラメータグループのファミリーが新しいエンジンバージョンと互換性があることを確認してください。1.2.0.0 より前のエンジンバージョンでは、パラメータグループファミリー neptune1 が使用されていましたが、1.2.0.0 以降のエンジンリリースでは、パラメータグループファミリー neptune1.2 が必要です。詳細については「Amazon Neptune パラメータグループ」を参照してください。

メジャーエンジンバージョンアップグレードの場合、適切なファミリーのパラメータグループを DBCluster DBInstanceParameterGroupName フィールドで指定します。

デフォルトのパラメータグループは、新しいエンジンバージョンと互換性のあるものにアップグレードする必要があります。

Neptune はエンジンのアップグレード後に DB インスタンスを自動的に再起動することに注意してください。