Usar um modelo do CloudFormation para atualizar a versão do mecanismo do cluster de banco de dados do Neptune

É possível reutilizar o modelo do CloudFormation do Neptune que você usou para criar o cluster de banco de dados do Neptune para atualizar a versão do mecanismo.

As atualizações da versão do mecanismo do Neptune podem ser secundárias ou principais. Usar um modelo do CloudFormation pode ajudar nas atualizações de versões principais, 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 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 do Neptune para atualizar a versão do mecanismo, ela simplesmente criava um cluster de banco de dados vazio no lugar do atual. No entanto, a partir de 17 de maio de 2023, a pilha CloudFormation do Neptune é compatível com atualizações de mecanismos locais que preservam os dados existentes.

Para uma atualização de versão principal, o modelo deve definir as seguintes propriedades em DBCluster:

Da mesma forma, para DBInstances anexadas ao DBCluster, você deve definir:

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 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 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.