

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usando um CloudFormation modelo para atualizar a versão do mecanismo do seu Neptune DB Cluster
<a name="cfn-engine-update"></a>

Você pode reutilizar o modelo CloudFormation Neptune que você usou para criar seu Neptune DB Cluster para atualizar sua versão do mecanismo.

As atualizações da versão do mecanismo do Neptune podem ser secundárias ou principais. Usar um CloudFormation modelo pode ajudar nas principais atualizações de versões, que geralmente contêm alterações significativas. Como as atualizações de versões principais podem conter as alterações de banco de dados incompatíveis com as aplicações existentes, talvez você também precise fazer as alterações nas aplicações durante a atualização. Sempre [teste antes de realizar a atualização](engine-maintenance-management.md#always-test-before-upgrading) e é altamente recomendável sempre criar um snapshot manual do cluster de banco de dados.

Observe que você precisa fazer uma atualização de mecanismo separada para cada versão principal. Você não pode ignorar uma versão principal e realizar a atualização diretamente para a versão principal a seguir.

Antes de 17 de maio de 2023, se você usava a pilha CloudFormation Neptune para atualizar sua versão do mecanismo, ela simplesmente criava um novo cluster de banco de dados vazio no lugar do seu atual. A partir de 17 de maio de 2023, no entanto, a pilha CloudFormation Neptune agora oferece suporte a atualizações de mecanismos locais que preservam seus dados existentes.

**nota**  
 Se você estiver usando o AWS Cloud Development Kit (AWS CDK), verifique se a AWS CDK versão que está sendo usada é 2.82.0 ou posterior. As versões anteriores à 2.82.0 não oferecem suporte às atualizações do mecanismo do Neptune no local. 

Para uma atualização de versão principal, o modelo deve definir as seguintes propriedades em `DBCluster`:
+ `DBClusterParameterGroup` (personalizado ou padrão)
+ `DBInstanceParameterGroupName`
+ `EngineVersion`

Da mesma forma, para DBInstances anexar a DBCluster você deve definir:
+ `DBParameterGroup` (personalizado/padrão)

Garanta que todos os grupos de parâmetros estejam definidos no modelo, sejam eles padrão ou personalizados.

No caso de um grupo de parâmetros personalizado, garanta que a família do grupo de parâmetros personalizado existente seja compatível com a nova versão do mecanismo. As versões do mecanismo anteriores à [1.2.0.0](engine-releases-1.2.0.0.md) usavam a família de grupos de parâmetros `neptune1`, enquanto as versões do mecanismo a partir da 1.2.0.0 exigem a família de grupos de parâmetros `neptune1.2`. Consulte [Grupos de parâmetros do Amazon Neptune](parameter-groups.md) para obter mais informações.

Para atualizações de versões principais do mecanismo, especifique um grupo de parâmetros com a família apropriada no campo `DBInstanceParameterGroupName` do `DBCluster`.

Um grupo de parâmetros padrão deve ser atualizado para um que seja compatível com a nova versão do mecanismo.

Observe que o Neptune reinicia automaticamente as instâncias de banco de dados após uma atualização do mecanismo.

**Topics**
+ [Exemplo: atualização secundária do mecanismo de 1.2.0.1 para 1.2.0.2](cfn-engine-update-1201-1202.md)
+ [Exemplo: atualização da versão principal de 1.1.1.0 para 1.2.0.2 com grupos de parâmetros padrão](cfn-engine-update-1110-1202-default.md)
+ [Exemplo: atualização da versão principal de 1.1.1.0 para 1.2.0.2 com grupos de parâmetros personalizados](cfn-engine-update-1110-1202-custom.md)
+ [Exemplo: atualização da versão principal de 1.1.1.0 para 1.2.0.2 com uma mistura de grupos de parâmetros padrão e personalizados](cfn-engine-update-1110-1202-mixed.md)