# Pasos para realizar una actualización local También le recomendamos que revise el material de referencia en [Cómo funciona la actualización de la versión principal en el lugar Aurora MySQL](AuroraMySQL.Updates.MajorVersionUpgrade.md#AuroraMySQL.Upgrading.Sequence). Realice cualquier planificación y prueba previas a la actualización, tal y como se describe en [Planificación de una actualización de versión principal para un clúster Aurora MySQL](AuroraMySQL.Updates.MajorVersionUpgrade.md#AuroraMySQL.Upgrading.Planning). ## Consola En el ejemplo siguiente se actualiza el clúster de base de datos `mydbcluster-cluster` a la versión Aurora MySQL 3.04.1. **Para actualizar la versión principal de un clúster de base de datos Aurora MySQL** 1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Si utilizó un grupo de parámetros personalizado con el clúster de base de datos original, cree un grupo de parámetros compatible con la nueva versión principal. Realice los ajustes necesarios en los parámetros de configuración del nuevo grupo de parámetros. Para obtener más información, consulte [Cómo afectan las actualizaciones en el lugar a los grupos de parámetros de un clúster](#AuroraMySQL.Upgrading.ParamGroups). 1. En el panel de navegación, seleccione **Databases (Bases de datos)**. 1. En la lista, elija el clúster de base de datos que desea modificar. 1. Elija **Modify**. 1. Para **Version** (Versión), elija una nueva versión principal de Aurora. También le recomendamos que utilice la versión secundaria de la versión principal. A continuación, elegimos la versión predeterminada actual. ![Actualice in situ un clúster de base de datos de Aurora MySQL de la versión 2 a la versión 3.](https://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/images/ams-upgrade-v2-v3.png) 1. Elija **Continue**. 1. En la página siguiente, especifique cuándo realizar la actualización. Seleccione **During the next scheduled maintenance window (Durante la siguiente ventana de mantenimiento programado)** o **Immediately (Inmediatamente)**. 1. (Opcional) Examine periódicamente la página **Events** (Eventos) de la consola RDS durante la actualización. Esto le ayuda a supervisar el progreso de la actualización e identificar cualquier problema. Si la actualización encuentra algún problema, consulte [Solución de problemas para la actualización Aurora MySQL en el lugar](AuroraMySQL.Upgrading.Troubleshooting.md) para conocer los pasos a seguir. 1. Si creó un nuevo grupo de parámetros al inicio de este procedimiento, asocie el grupo de parámetros personalizados con el clúster actualizado. Para obtener más información, consulte [Cómo afectan las actualizaciones en el lugar a los grupos de parámetros de un clúster](#AuroraMySQL.Upgrading.ParamGroups). **nota** Para realizar este paso, deberá reiniciar el clúster de nuevo para aplicar el nuevo grupo de parámetros. 1. (Opcional) Después de completar las pruebas posteriores a la actualización, elimine la instantánea manual que Aurora creó al comienzo de la actualización. ## AWS CLI Para actualizar la versión principal de un clúster de base de datos de Aurora MySQL, utilice el comando [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) de la AWS CLI con los siguientes parámetros requeridos: + `--db-cluster-identifier` + `--engine-version` + `--allow-major-version-upgrade` + `--apply-immediately` o `--no-apply-immediately` Si el clúster utiliza algún grupo de parámetros personalizados, incluya también una o ambas opciones: + `--db-cluster-parameter-group-name`, si el clúster utiliza un grupo de parámetros de clúster personalizado + `--db-instance-parameter-group-name`, si alguna instancia del clúster utiliza un grupo de parámetros de base de datos personalizado En el ejemplo siguiente se actualiza el clúster de base de datos `sample-cluster` a la versión Aurora MySQL 3.04.1. La actualización se realiza inmediatamente, en lugar de esperar la siguiente ventana de mantenimiento. **Example** Para Linux, macOS o Unix: ``` aws rds modify-db-cluster \ --db-cluster-identifier sample-cluster \ --engine-version 8.0.mysql_aurora.3.04.1 \ --allow-major-version-upgrade \ --apply-immediately ``` Para Windows: ``` aws rds modify-db-cluster ^ --db-cluster-identifier sample-cluster ^ --engine-version 8.0.mysql_aurora.3.04.1 ^ --allow-major-version-upgrade ^ --apply-immediately ``` Puede combinar otros comandos de CLI con `modify-db-cluster` para crear un proceso automatizado de extremo a extremo para realizar y verificar actualizaciones. Para obtener más información y ejemplos, consulte [Tutorial de actualización de Aurora MySQL en el lugar](AuroraMySQL.Upgrading.Tutorial.md). **nota** Si el clúster forma parte de una base de datos global Aurora, el procedimiento de actualización en el lugar es ligeramente diferente. Se llama a la operación de comando [modify-global-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-global-cluster.html) en lugar de `modify-db-cluster`. Para obtener más información, consulte [Actualizaciones mayores en el lugar para bases de datos globales](#AuroraMySQL.Upgrading.GlobalDB). ## API de RDS Para actualizar la versión principal de un clúster de base de datos Aurora MySQL, utilice la operación de la API de RDS [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) con los siguientes parámetros requeridos: + `DBClusterIdentifier` + `Engine` + `EngineVersion` + `AllowMajorVersionUpgrade` + `ApplyImmediately` (establecido en `true` o `false`) **nota** Si el clúster forma parte de una base de datos global Aurora, el procedimiento de actualización en el lugar es ligeramente diferente. Se llama a la operación [ModifyGlobalCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyGlobalClusterParameterGroup.html) en lugar de `ModifyDBCluster`. Para obtener más información, consulte [Actualizaciones mayores en el lugar para bases de datos globales](#AuroraMySQL.Upgrading.GlobalDB). ## Cómo afectan las actualizaciones en el lugar a los grupos de parámetros de un clúster Los grupos de parámetros de Aurora tienen diferentes conjuntos de opciones de configuración para los clústeres compatibles con versiones diferentes de MySQL. Al realizar una actualización local, el clúster actualizado y todas sus instancias deben utilizar los grupos de parámetros de clúster e instancia correspondientes que son compatibles con la nueva versión principal. Si el clúster y las instancias utilizan los grupos predeterminados de parámetros para la versión de origen, las instancias y el clúster actualizados comienzan automáticamente con los grupos predeterminados de parámetros para la versión de destino. Si el clúster y las instancias utilizan algún grupo de parámetros personalizado, asegúrese de crear los correspondientes grupos de parámetros compatibles con la versión de destino. También asegúrese de especificarlos durante el proceso de actualización. En la tabla siguiente se muestra la asignación de grupos de parámetros predeterminados para cada ruta de actualización: | Ruta de actualización | Grupo de parámetros predeterminado de origen | Grupo de parámetros predeterminado de destino | | --- | --- | --- | | De la versión 2 a la versión 3 de Aurora MySQL | default.aurora-mysql5.7 | default.aurora-mysql8.0 | | De la versión 3 a la versión 8.4 de Aurora MySQL | default.aurora-mysql8.0 | default.aurora-mysql8.4 | **nota** Para la mayoría de las configuraciones de parámetros, puede elegir el grupo de parámetros personalizado en dos puntos. Esto es al crear el clúster o asociar el grupo de parámetros al clúster más adelante. Sin embargo, si utiliza una configuración no predeterminada para el parámetro `lower_case_table_names`, debe configurar el grupo de parámetros personalizado con esta configuración de antemano. A continuación, especifique el grupo de parámetros durante la restauración de instantáneas para la creación de clúster. Cualquier cambio en el parámetro `lower_case_table_names` no tiene efecto después de crear el clúster. Recomendamos que utilice la misma configuración para `lower_case_table_names` cuando realice una actualización de versión principal. Con una base de datos global de Aurora basada en Aurora MySQL, puede realizar una actualización local de la versión principal solo si establece el parámetro `lower_case_table_names` en el valor predeterminado y reinicia la base de datos global. Para obtener más información sobre los métodos que puede utilizar, consulte [Actualizaciones de la versión principal](aurora-global-database-upgrade.md#aurora-global-database-upgrade.major). ## Cambios en las propiedades del clúster entre versiones de Aurora MySQL Al realizar una actualización de la versión principal, asegúrese de comprobar cualquier aplicación o script que utilice para configurar o administrar clústeres e instancias de bases de datos de Aurora MySQL. Además, cambie el código que manipula los grupos de parámetros para tener en cuenta el hecho de que los nombres de grupos de parámetros predeterminados son diferentes en cada versión principal. **De la versión 2 a la versión 3 de Aurora MySQL** Por ejemplo, es posible que tenga código como el siguiente que se aplique al clúster antes de una actualización. ``` # Check the default parameter values for MySQL 5.7–compatible clusters. aws rds describe-db-parameters {{--db-parameter-group-name default.aurora-mysql5.7}} --region us-east-1 ``` Después de actualizar la versión principal del clúster, modifique ese código de la siguiente manera. ``` # Check the default parameter values for MySQL 8.0–compatible clusters. aws rds describe-db-parameters {{--db-parameter-group-name default.aurora-mysql8.0}} --region us-east-1 ``` **De la versión 3 a la versión 8.4 de Aurora MySQL** Del mismo modo, si tiene un código que hace referencia al grupo de parámetros predeterminado de la versión 3, actualícelo una vez realizada la actualización. ``` # Before upgrade: Check the default parameter values for MySQL 8.0–compatible clusters. aws rds describe-db-parameters {{--db-parameter-group-name default.aurora-mysql8.0}} --region us-east-1 ``` ``` # After upgrade: Check the default parameter values for MySQL 8.4–compatible clusters. aws rds describe-db-parameters {{--db-parameter-group-name default.aurora-mysql8.4}} --region us-east-1 ``` ## Actualizaciones mayores en el lugar para bases de datos globales Para una base de datos global de Aurora, actualice el clúster de la base de datos global. Aurora actualiza automáticamente todos los clústeres al mismo tiempo y se asegura de que todos ejecuten la misma versión del motor. Este requisito se debe a que cualquier cambio en las tablas del sistema, formatos de archivo de datos, etc., se replican automáticamente en todos los clústeres secundarios. Siga las instrucciones en [Cómo funciona la actualización de la versión principal en el lugar Aurora MySQL](AuroraMySQL.Updates.MajorVersionUpgrade.md#AuroraMySQL.Upgrading.Sequence). Cuando especifique qué actualizar, asegúrese de elegir el clúster de base de datos global en lugar de uno de los clústeres que contiene. Si utiliza la Consola de administración de AWS, elija el elemento con el rol **Global database** (Base de datos global). ![Actualización del clúster de base de datos global.](https://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/images/aurora-global-databases-major-upgrade-global-cluster.png) Si utiliza la AWS CLI o la API de RDS, inicie el proceso de actualización llamando al comando [modify-global-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-global-cluster.html) o la operación [ModifyGlobalCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyGlobalCluster.html). Se usa uno de estos en lugar de `modify-db-cluster` o `ModifyDBCluster`. **nota** No puede especificar un grupo de parámetros personalizado para el clúster de base de datos global mientras realiza una actualización importante de la versión de esa base de datos global de Aurora. Cree grupos de parámetros personalizados en cada región del clúster global. A continuación, aplíquelos manualmente a los clústeres regionales después de la actualización. Para actualizar la versión principal de un clúster de base de datos global de Aurora MySQL, utilice el comando [modify-global-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-global-cluster.html) de la AWS CLI con los siguientes parámetros requeridos: + `--global-cluster-identifier` + `--engine aurora-mysql` + `--engine-version` + `--allow-major-version-upgrade` En el ejemplo siguiente se actualiza el clúster de base de datos global a la versión 3.04.2 de Aurora MySQL. **Example** Para Linux, macOS o Unix: ``` aws rds modify-global-cluster \ --global-cluster-identifier {{global_cluster_identifier}} \ --engine aurora-mysql \ --engine-version 8.0.mysql_aurora.3.04.2 \ --allow-major-version-upgrade ``` Para Windows: ``` aws rds modify-global-cluster ^ --global-cluster-identifier {{global_cluster_identifier}} ^ --engine aurora-mysql ^ --engine-version 8.0.mysql_aurora.3.04.2 ^ --allow-major-version-upgrade ``` ## Actualizaciones in situ para clústeres de bases de datos con réplicas de lectura entre regiones Puede actualizar un clúster de base de datos de Aurora que tenga una réplica de lectura entre regiones mediante el procedimiento de actualización in situ, pero hay que tener en cuenta algunos aspectos: + Primero, debe actualizar el clúster de base de datos de réplica de lectura. Si intenta actualizar primero el clúster principal, recibirá un mensaje de error como el siguiente: Unable to upgrade DB cluster test-xr-primary-cluster because the associated Aurora cross-Region replica test-xr-replica-cluster isn't patched yet. Upgrade the Aurora cross-Region replica and try again. Esto significa que el clúster de base de datos principal no puede tener una versión del motor de base de datos superior a la del clúster de réplica. + Antes de actualizar el clúster de base de datos principal, detenga la carga de trabajo de escritura e inhabilite cualquier nueva solicitud de conexión a la instancia de base de datos de escritor del clúster principal. + Cuando actualice el clúster principal, elija un grupo de parámetros de clúster de base de datos personalizado con el parámetro `binlog_format` establecido en un valor que admita la replicación de registros binarios, como `MIXED`. Para obtener más información sobre la utilización del registro binario con Aurora MySQL, consulte [Replicación entre Aurora y MySQL o entre Aurora y otro clúster de base de datos de Aurora (replicación de registro binario)](AuroraMySQL.Replication.MySQL.md). Para obtener más información acerca de cómo modificar los parámetros de configuración de Aurora MySQL, consulte [Parámetros de configuración de Aurora MySQL](AuroraMySQL.Reference.ParameterGroups.md) y [Grupos de parámetros para Amazon Aurora](USER_WorkingWithParamGroups.md). + No espere mucho tiempo para actualizar el clúster de base de datos principal después de actualizar el clúster de réplica. Recomendamos no esperar más allá de la siguiente ventana de mantenimiento. + Tras actualizar el clúster de base de datos principal, reinicie su instancia de base de datos de escritor. El grupo de parámetros del clúster de base de datos personalizado que permite la replicación de binlog no surtirá efecto hasta que se reinicie la instancia de base de datos de escritor. + No reanude la carga de trabajo de escritura ni habilite las conexiones a la instancia de base de datos de escritor hasta que confirme que la replicación entre regiones se ha reiniciado y que el retraso de la réplica en la Región de AWS secundaria es 0.