Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Actualización local de la versión principal Amazon DocumentDB
Amazon DocumentDB hace que estén disponibles en las nuevas versiones del motor de base de datos solo después de realizar pruebas exhaustivas. Puede elegir cuándo y cómo actualizar sus clústeres de Amazon DocumentDB a la nueva versión.
Actualmente, Amazon DocumentDB admite tres versiones principales: Amazon DocumentDB 3.6, 4.0 y 5.0. Puede realizar una actualización local de la versión principal (MVU) de la base de datos y, al mismo tiempo, conservar los mismos puntos de conexión, almacenamiento y etiquetas de los clústeres, y seguir utilizando las aplicaciones sin ninguna modificación. Esta función está disponible de forma gratuita en todas las regiones en las que Amazon DocumentDB 5.0 está disponible.
importante
Los clústeres de Amazon DocumentDB no estarán disponibles durante la actualización de la versión principal y los clústeres se reiniciarán varias veces. El tiempo de inactividad de la actualización puede variar de un clúster a otro en función del número de colecciones, índices, bases de datos e instancias. Recomendamos realizar la actualización durante el período de mantenimiento o durante las horas de baja utilización. Una vez actualizado el clúster, no puede cambiarlo a una versión anterior, pero puede optar por restaurar la instantánea previa a la actualización en un clúster nuevo.
Temas
- MVUrequisitos previos y limitaciones
- Prácticas recomendadas para actualizaciones de la versión principal locales
- Actualización local de la versión principal
- Diferencias entre los clústeres actualizados de Amazon DocumentDB 3.6/4.0 a 5.0 y los nuevos clústeres de Amazon DocumentDB 5.0
- Solución de problemas de una actualización local de la versión principal
MVUrequisitos previos y limitaciones
A continuación se indican los requisitos previos y las limitaciones de la actualización inmediata de la versión principal que quizá tenga que entender y cumplir antes de realizar la actualización:
Tipo de instancia: Amazon DocumentDB 4.0/5.0 no admite instancias r4.*. Para continuar con la actualización inmediata de la versión principal, cambie las instancias r4.* por las instancias r5.*. Para obtener más información, consulte Modificación de una instancia de base de datos de Amazon DocumentDB. Consulte las Clases de instancias admitidas por región instancias compatibles basadas en la versión del motor Amazon DocumentDB.
Parches del sistema operativo de la instancia: una actualización de una versión principal implementada necesita el último parche del sistema operativo (SO) para continuar. Aplique todas las acciones pendientes de mantenimiento del sistema operativo a las instancias antes de continuar con la actualización local. Para obtener más información, consulte Actualizaciones del sistema operativo Amazon DocumentDB.
nota
En algunas situaciones, si tiene parches de motor pendientes a nivel de clúster, los parches del sistema operativo de la instancia no están visibles. Quizá tenga que aplicar los parches del motor a nivel de clúster antes de proceder a aplicar los parches del sistema operativo de la instancia y, posteriormente, realizar la actualización de la versión principal ya implementada. Consulte Actualización de un parche a la versión del motor de un clúster.
La actualización inmediata de la versión principal está disponible en todas las regiones en las que Amazon DocumentDB 5.0 está disponible.
-
La actualización local de la versión principal no es compatible con Amazon DocumentDB 4.0 como versión de destino.
-
A partir de Amazon DocumentDB 4.0, no se admite «.» en los nombres de usuario. Si está actualizando de Amazon DocumentDB 3.6 a 5.0 y tiene un nombre de usuario que contiene» . «, vuelva a crear su nombre de usuario sin» . «, antes de continuar con la operación in situ. MVU
La actualización local de la versión principal no se admite actualmente en los clústeres globales y elásticos de Amazon DocumentDB.
nota
Para actualizar los clústeres globales, elimine los clústeres secundarios del clúster global, convierta el clúster principal en un clúster regional, actualice la versión principal local del clúster regional (principal) y, a continuación, vuelva a crear el clúster global añadiendo clústeres secundarios con el mismo nombre para conservar los mismos puntos de conexión que antes. Tenga en cuenta que incurrirá en gastos de IO mientras el clúster principal actualizado replique los datos en los clústeres secundarios recién agregados. Para ver los pasos detallados sobre cómo eliminar los clústeres secundarios del clúster global antes de eliminarlos, consulte Eliminación de un clúster global de Amazon DocumentDB.
-
Si tiene una gran cantidad de índices (más de 3000) que funcionan en instancias de rendimiento estable (por ejemplo, t3.medium o t4g.medium), debe ampliar la instancia principal a una instancia más grande (por ejemplo, al menos r5.large) para realizar la actualización local de la versión principal. Puede optar por reducir el tamaño de la instancia una vez que se haya completado la actualización local de la versión principal. Consulte la tabla siguiente para ver el número máximo de índices compatibles con los tipos de instancia db.t3 y db.t4g para una actualización de versión principal local:
instancia Número máximo de índices admitidos para las versiones locales MVU db.t4g.medium
3,000
db.t3.medium
10,000
Prácticas recomendadas para actualizaciones de la versión principal locales
Prueba de las actualizaciones locales de la versión principal mediante clústeres clonados
-
Para probar las actualizaciones de las versiones principales locales, le recomendamos que utilice la función de clonación rápida para crear un clon del clúster de destino. No incurrirá en ningún costo de almacenamiento por probar la actualización local de la versión principal en un volumen clonado, a menos que modifique los datos del clúster. Para obtener más información acerca de la clonación, consulte Clonación de un volumen de clúster de base de datos de Amazon DocumentDB.
-
Para obtener una estimación más realista del tiempo necesario para completar la actualización local de la versión principal, haga coincidir el número de instancias del clúster clonado con el clúster de destino.
-
Recomendamos probar completamente el clúster Amazon DocumentDB 5.0 recién actualizado para detectar cualquier diferencia funcional a fin de garantizar que todo funcione según lo esperado.
Antes de una actualización local de la versión principal
-
Tenga preparado un grupo de parámetros de clúster compatible con la versión.
Utilice el grupo de parámetros de clúster predeterminado de Amazon DocumentDB para la nueva versión del motor o cree su propio grupo de parámetros de clúster personalizado para la nueva versión del motor.
Si asocia un grupo de parámetros de clúster de Amazon DocumentDB como parte de la solicitud de actualización, la actualización local de la versión principal Amazon DocumentDB como parte de la solicitud de actualización, la actualización local de la versión principal Amazon DocumentDB para aplicar el nuevo grupo de parámetros.
-
Asegúrese de cumplir los requisitos previos para una actualización local de la versión principal, tal como se menciona en la sección Requisitos previos y limitaciones.
-
Para crear una instantánea manual.
El proceso de actualización crea una instantánea del clúster de base de datos durante la actualización. Se recomienda encarecidamente crear su propia instantánea manual antes del proceso de actualización. Consulte Crear una instantánea de clúster manual.
nota
La instantánea automática creada por el proceso de actualización no se eliminará automáticamente una vez que se haya completado la actualización local de la versión principal. Esta instantánea no incurrirá en ningún cargo mientras se encuentre dentro del período de retención. Puede optar por eliminar esta instantánea una vez que haya comprobado que la actualización del clúster se ha realizado correctamente.
La instantánea se denomina
preupgrade-<name>-<version>-<timestamp>.
-
Compruebe si ya ha programado una actualización local de la versión principal de su clúster.
Si ha modificado el clúster y ha seleccionado aplicarlo en el siguiente período de mantenimiento, el programa de actualización de la versión principal vigente no estará visible en la consola, pero podrá verlo en la. CLI Puede ejecutar el siguiente comando para comprobar si ya está programada una actualización local de la versión principal:
aws docdb describe-db-cluster \ --region $REGION \ --db-cluster-identifier $CLUSTER_NAME "PendingModifiedValues": { "EngineVersion": "5.0.0" }, Realice varias ejecuciones en seco utilizando un clon de volumen en entornos más bajos para probar el clúster tras la actualización local de la versión principal en función de cualquier plan de ejecución y diferencias funcionales. Recomendamos clonar con el mismo número y tamaño de instancias para obtener una mejor estimación del tiempo de ejecución de la actualización local de la versión principal. Para obtener más información, consulte Clonación de un volumen de clúster de base de datos de Amazon DocumentDB.
Si el paso anterior se realiza correctamente, continúe con la actualización local de la versión principal en el clúster de producción.
Durante una actualización local de la versión principal
Puede supervisar el progreso de la actualización local de la versión principal suscribiéndose a los eventos de mantenimiento del clúster. Cuando se complete la actualización, recibirá el evento “Se ha actualizado la versión principal del clúster de bases de datos”. Este y otros eventos que se producen durante la actualización aparecen en la sección “Eventos y etiquetas” de la página de detalles del clúster en la consola de Amazon DocumentDB. A continuación, el estado del clúster cambia de “actualizado” a “disponible”.
DesdeCLI, puede correr aws docdb create-event-subscription para crear eventos y supervisar aws docdb describe-events el progreso. También puedes configurar notificaciones de eventos para los eventos anteriores a Amazon SNS como destino para recibir notificaciones por correo electrónico, mensajes push y otros métodos. Para obtener más información, consulte Suscripción a eventos de Amazon DocumentDB.
La actualización local de la versión principal genera los siguientes eventos durante la actualización:
Actualización en curso: creación de una instantánea previa a la actualización [preupgrade-<cluster-name>-<timestamp>]
Actualización en curso: volumen de clonación.
Actualización en curso: actualización del escritor.
Actualización en curso: actualización de los lectores.
Se ha actualizado la versión principal del motor de clústeres de bases de datos.
Los eventos también están visibles en la consola, en la página Eventos:
En el AWS CLI, puede utilizar los siguientes comandos para realizar un seguimiento del progreso:
aws docdb describe-events --source-identifier $CLUSTER_NAME --source-type db-cluster { "Events": [ { "SourceIdentifier": "mycluster", "SourceType": "db-cluster", "Message": "Database cluster engine version upgrade started.", "EventCategories": [ "maintenance" ], "Date": "2023-07-11T23:20:32.444000+00:00", "SourceArn": "arn:aws:rds:us-east-1:xxxx:cluster:mycluster" } ] }
Después de una actualización local de la versión principal
Para Amazon DocumentDB 3.6, añada una etiqueta al clúster para diferenciar que el clúster se actualizó a Amazon DocumentDB 5.0 desde Amazon DocumentDB 3.6 y no a un clúster de Amazon DocumentDB 5.0 recién creado. Consulte la sección sobre las diferencias entre un clúster de Amazon DocumentDB 5.0 actualizado y un clúster de Amazon DocumentDB 5.0 nuevo.
Realice una instantánea manual cuando finalice la actualización local de la versión principal, en caso de que necesite restaurarla al estado posterior a la actualización. El proceso de creación automática de instantáneas se reanudará en cuanto se complete la actualización local de la versión principal. La instantánea manual no incurrirá en ningún cargo mientras se encuentre dentro del período de retención.
Para utilizar las nuevas funciones asociadas a Amazon DocumentDB 5.0, por ejemplo, el cifrado a nivel de campo del lado del cliente, le recomendamos que actualice la versión del controlador a la versión MongoDB 5.0. API Para obtener más información, consulte Novedades de Amazon DocumentDB 5.0 para ver una la lista de características de Amazon DocumentDB 5.0.
importante
Inmediatamente después de realizar la actualización de la versión principal (MVU) in situ, el clúster de Amazon DocumentDB 5.0 rellenará los metadatos del índice, en función de los cuales el motor de base de datos optimiza los planes de ejecución de las consultas. El rendimiento esperado de las consultas en el clúster de Amazon DocumentDB se reanudará una vez finalizado el proceso de recálculo de los metadatos del índice. Por lo general, este proceso se completa en unos minutos, pero puede durar hasta dos horas, según la cantidad de índices del clúster.
Además, un reinicio inmediato, una conmutación por error o una ampliación o reducción de la instancia de escritura una vez instalada pueden interrumpir el proceso de MVU cálculo de los metadatos del índice en el clúster. Una vez finalizada la implementaciónMVU, le recomendamos que realice dichos cambios una vez que observe el rendimiento esperado de las consultas en su clúster de Amazon DocumentDB 5.0.
Póngase en contacto con el servicio de AWS asistencia si observa que esta caída temporal del rendimiento persiste durante más de dos horas después de su instalación. MVU
Pruebe completamente el clúster actualizado de Amazon DocumentDB 5.0 para asegurarse de que todo funciona según lo esperado.
nota
Tras realizar una operación in situ MVU en un clúster de Amazon DocumentDB con las secuencias de cambios habilitadas, los eventos de la secuencia de cambios anteriores se conservan y se pueden reanudar resumeToken mediante o. startAtOperationTime Como ocurre con cualquier clúster de Amazon DocumentDB recién creado, cambie los registros de eventos de transmisión anteriores a los que change_stream_log_retention_duration se eliminan si el tamaño del registro es superior a 51.200 MB.
Actualización local de la versión principal
Diferencias entre los clústeres actualizados de Amazon DocumentDB 3.6/4.0 a 5.0 y los nuevos clústeres de Amazon DocumentDB 5.0
-
Comparaciones de subdocumentos para varios tipos de datos numéricos:
-
Si el clúster se migra desde Amazon DocumentDB 3.6, heredará el comportamiento de comparación de subdocumentos de Amazon DocumentDB 3.6. La diferencia funcional se limita a los tipos numéricos (como Long, Double o Decimal128) en un subdocumento. Por ejemplo,
{a: {b: {NumberLong(1)}}no es igual que{a: {b: 1}}en Amazon DocumentDB 3.6, mientras que se comparan como iguales en Amazon DocumentDB 4.0 y versiones posteriores. -
Este comportamiento de comparación de subdocumentos solo existe en los clústeres de Amazon DocumentDB 3.6 y Amazon DocumentDB 5.0 que se actualizaron desde la versión 3.6 mediante una actualización local de la versión principal. Esto no se aplica a los clústeres de Amazon DocumentDB 5.0 recién creados.
-
-
Una actualización local de la versión principal conserva los índices originales del clúster actualizado. Como práctica recomendada general, le recomendamos eliminar los índices y volver a crearlos una vez que la versión local se complete correctamente. MVU Con Amazon DocumentDB 5.0, hemos mejorado la eficiencia general del proceso de recolección de elementos no utilizados, especialmente en el caso de índices de cardinalidad bajos. Si ha tenido problemas con la recolección de elementos no utilizados en sus clústeres de Amazon DocumentDB 3.6 o 4.0, esos clústeres se beneficiarán al eliminar los índices y volver a crearlos posteriormente. MVU No es obligatorio volver a crear los índices. Sin embargo, la recreación de un índice puede implicar E/S y tiempo adicionales. Para obtener más información, consulte Administración de índices de Amazon DocumentDB.
nota
Para obtener una lista de las diferencias funcionales entre Amazon DocumentDB 3.6/4.0 y Amazon DocumentDB 5.0, consulte Compatibilidad de Amazon DocumentDB con MongoDB.
Solución de problemas de una actualización local de la versión principal
En caso de que se produzca un error, la actualización local de la versión principal intentará anular la actualización para adoptar el último estado operativo del clúster antes de que se iniciara la actualización. Una reversión correcta generará un evento: “El clúster de base de datos está en un estado que no se puede actualizar: el clúster de DocumentDB se encuentra en un estado en el que la actualización de la versión principal no se puede completar correctamente”. En este punto, debe comunicarse con el equipo de AWS soporte para solucionar el problema y volver a intentar la actualización de la versión. Puede seguir utilizando su carga de trabajo como antes. En cualquier otro caso poco frecuente en el que la actualización tarde más de lo esperado, ponte en contacto con el equipo de AWS soporte para obtener ayuda.
Una vez que la instalación se MVU complete correctamente, es posible que el clúster actualizado experimente una degradación temporal del rendimiento y un alto nivel de CPU utilización durante un breve período de tiempo, mientras se ejecuta el proceso de actualización de los metadatos del índice. Si continúa experimentando una degradación del rendimiento durante más de 2 horas, póngase en contacto con el servicio de AWS asistencia.
