Usando um AWS CloudFormation modelo para atualizar a versão do mecanismo do seu cluster de banco de dados Neptune - Amazon Neptune

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 AWS CloudFormation modelo para atualizar a versão do mecanismo do seu cluster de banco de dados Neptune

Você pode reutilizar o modelo do AWS 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 AWS 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 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 AWS 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 AWS 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 locais do Neptune Engine.

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