本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 CloudFormation 模板更新 Neptune 数据库集群的引擎版本
<a name="cfn-engine-update"></a>

您可以重复使用用于创建 Nept CloudFormation une 数据库集群的 Neptune 模板来更新其引擎版本。

Neptune 引擎版本升级可以是次要版本升级，也可以是主要版本升级。使用 CloudFormation 模板可以帮助进行主要版本升级，其中通常包含重大更改。由于主要版本升级可能包含不与现有应用程序向后兼容的数据库更改，因此在升级时您可能还需要对应用程序进行更改。请务必[在升级之前进行测试](engine-maintenance-management.md#always-test-before-upgrading)，我们强烈建议您在升级之前，始终创建数据库集群的手动快照。

请注意，您必须为每个主要版本单独进行引擎升级。您不能跳过某个主要版本并直接升级到以下主要版本。

在 2023 年 5 月 17 日之前，如果您使用 Neptune CloudFormation 堆栈升级引擎版本，它只会创建一个新的空数据库集群来代替当前的数据库集群。但是，从2023年5月17日起，Neptune CloudFormation 堆栈现在支持就地升级引擎，以保留您的现有数据。

**注意**  
 如果您使用的是 AWS Cloud Development Kit (AWS CDK)，请确保使用的 AWS CDK 版本是 2.82.0 或更高版本。2.82.0 之前的版本不支持就地升级 Neptune 引擎。

对于主要版本升级，您的模板应在 `DBCluster` 中设置以下属性：
+ `DBClusterParameterGroup`（自定义或默认）
+ `DBInstanceParameterGroupName`
+ `EngineVersion`

同样，要 DBInstances 附加到， DBCluster 则应设置：
+ `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 会在引擎升级后自动重启数据库实例。

**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)