

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CloudFormation テンプレートを使用して Neptune DB クラスターのエンジンバージョンを更新する
<a name="cfn-engine-update"></a>

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

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

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

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

**注記**  
 を使用している場合は AWS Cloud Development Kit (AWS CDK)、使用している AWS CDK バージョンが 2.82.0 以降であることを確認します。2.82.0 より前のバージョンでは、Neptune エンジンの in-place アップグレードはサポートされていません。

メジャーバージョンアップグレードの場合、テンプレートで `DBCluster` に次のプロパティを設定する必要があります。
+ `DBClusterParameterGroup` (カスタムまたはデフォルト)
+ `DBInstanceParameterGroupName`
+ `EngineVersion`

同様に、DBCluster にアタッチされた DBInstance に対しても以下を設定する必要があります。
+ `DBParameterGroup` (カスタム/デフォルト)

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

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

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

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

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

**Topics**
+ [例: 1.2.0.1 から 1.2.0.2 へのマイナーエンジンアップグレード](cfn-engine-update-1201-1202.md)
+ [例: デフォルトのパラメータグループによる 1.1.1.0 から 1.2.0.2 へのメジャーバージョンアップグレード](cfn-engine-update-1110-1202-default.md)
+ [例: カスタムパラメータグループによる 1.1.1.0 から 1.2.0.2 へのメジャーバージョンアップグレード](cfn-engine-update-1110-1202-custom.md)
+ [例: デフォルトパラメータグループとカスタムパラメータグループを組み合わせた 1.1.1.0 から 1.2.0.2 へのメジャーバージョンアップグレード](cfn-engine-update-1110-1202-mixed.md)