Uso de una plantilla de CloudFormation para actualizar la versión del motor del clúster de base de datos de Neptune - Amazon Neptune

Uso de una plantilla de CloudFormation para actualizar la versión del motor del clúster de base de datos de Neptune

Puede volver a utilizar la plantilla de CloudFormation de Neptune que utilizó para crear el clúster de base de datos de Neptune con el fin de actualizar la versión del motor.

Las actualizaciones de la versión del motor de Neptune pueden ser secundarias o principales. El uso de una plantilla de CloudFormation puede ayudar con las actualizaciones principales de las versiones, que suelen incluir cambios importantes. Dado que las actualizaciones principales de la versión pueden incluir cambios realizados en la base de datos que no son compatibles con las versiones anteriores de las aplicaciones, es posible que también necesite realizar cambios realizados en las aplicaciones durante la actualización. Siempre realice una prueba antes de realizar un actualización, y le recomendamos encarecidamente que siempre cree una instantánea manual del clúster de base de datos antes de realizar una actualización.

Tenga en cuenta que debe realizar una actualización del motor independiente para cada versión principal. No puede omitir una versión principal ni actualizarla directamente a la siguiente versión principal siguiente.

Antes del 17 de mayo de 2023, si utilizaba la pila CloudFormation de Neptune para actualizar la versión del motor, simplemente creaba un nuevo clúster de base de datos vacío en lugar del actual. Sin embargo, a partir del 17 de mayo de 2023, la pila CloudFormation de Neptune ahora admite actualizaciones de motor locales que conservan los datos existentes.

nota

Si utiliza AWS Cloud Development Kit (AWS CDK), asegúrese de que la versión de AWS CDK que utiliza es la 2.82.0 o posterior. Las versiones anteriores a la 2.82.0 no admiten las actualizaciones locales del motor de Neptune.

Para una actualización de una versión principal, la plantilla debe establecer las siguientes propiedades en DBCluster:

  • DBClusterParameterGroup (personalizado o predeterminado)

  • DBInstanceParameterGroupName

  • EngineVersion

Del mismo modo, para DBInstances asociadas a DBCluster, debe establecer:

  • DBParameterGroup (personalizado/predeterminado)

Asegúrese de que todos los grupos de parámetros estén definidos en la plantilla, ya sean predeterminados o personalizados.

En el caso de un grupo personalizado de parámetros, asegúrese de que la familia del grupo personalizado de existente sea compatible con la nueva versión del motor. Las versiones del motor anteriores a la versión 1.2.0.0 utilizaban la familia de grupos de parámetros neptune1, mientras que las versiones del motor a partir de la versión 1.2.0.0 requieren la familia de grupos de parámetros neptune1.2. Para obtener más información, consulte Grupos de parámetros de Amazon Neptune.

Para las principales actualizaciones de la versión del motor, especifique un grupo de parámetros con la familia adecuada en el campo DBInstanceParameterGroupName de DBCluster.

El grupo predeterminado de parámetros debe actualizarse a uno que sea compatible con la nueva versión del motor.

Tenga en cuenta que Neptune reinicia automáticamente las instancias de base de datos tras una actualización del motor.