Rutas de actualización admitidas Requisitos previos Prácticas recomendadas Qué cambia tras la actualización de Amazon DocumentDB 5.0 a 8.0 Post-upgrade consideraciones sobre los clústeres actualizados desde la versión 3.6 o 4.0 Aplicación de la actualización Resolución de problemas

Actualización local de la versión principal Amazon DocumentDB

Puede realizar una actualización local de la versión principal (MVU) de su clúster de Amazon DocumentDB manteniendo los mismos puntos de enlace, almacenamiento y etiquetas. Sus aplicaciones siguen funcionando sin modificaciones. Esta función está disponible sin coste adicional en todas las regiones en las que Amazon DocumentDB está disponible.

importante

El clúster no estará disponible durante la actualización y se reiniciará varias veces. No te conectes al clúster, ni leas desde él ni escribas en él después de iniciar la actualización. El tiempo de inactividad varía según la cantidad de colecciones, índices, bases de datos e instancias. Recomendamos realizar la actualización durante el período de mantenimiento o durante las horas de bajo consumo.

Una vez actualizada, no podrá cambiar a una versión anterior. Si es necesario, puede restaurar la instantánea previa a la actualización en un clúster nuevo.

Temas

Rutas de actualización admitidas
Requisitos previos
Prácticas recomendadas
Qué cambia tras la actualización de Amazon DocumentDB 5.0 a 8.0
Post-upgrade consideraciones sobre los clústeres actualizados desde la versión 3.6 o 4.0
Aplicación de la actualización
Resolución de problemas

Rutas de actualización admitidas

Versión de fuente	Versión de destino
Amazon DocumentDB 3.6	Amazon DocumentDB 5.0
Amazon DocumentDB 4.0	Amazon DocumentDB 5.0
Amazon DocumentDB 5.0	Amazon DocumentDB 8.0

nota

In-place MVU no es compatible con los clústeres globales o elásticos. Para actualizar un clúster global, elimine los clústeres secundarios, convierta el principal en un clúster regional, ejecute la MVU y, a continuación, vuelva a crear el clúster global añadiendo clústeres secundarios con los mismos nombres para conservar los puntos finales. Se le cobrarán I/O gastos mientras el servidor principal actualizado replique los datos en los nuevos dispositivos secundarios. Para ver los pasos detallados, consulte Eliminación de un clúster global de Amazon DocumentDB.

Requisitos previos

Tipo de instancia: Amazon DocumentDB 4.0+ no admite instancias db.r4. Modifique cualquier db.r4.* instancia por una instancia o una versión más reciente antes de realizar la db.r5.* actualización. Consulte Modificación de una instancia de base de datos de Amazon DocumentDB y Clases de instancias admitidas por región.
Parches del sistema operativo: aplique cualquier acción pendiente de mantenimiento del sistema operativo en todas las instancias antes de la actualización. Consulte Actualizaciones del sistema operativo de Amazon DocumentDB.

nota
Los parches de motor pendientes a nivel de clúster pueden ocultar los parches del sistema operativo de la instancia. Aplique primero los parches del motor si es necesario. Consulte Actualización de un parche a la versión del motor de un clúster.
Límites de indexación de las instancias con capacidad de fragmentación (instancias de la familia t): si tiene más de 3000 índices en instancias con capacidad de fragmentación, amplíe la instancia principal a db.r5.large como mínimo antes de realizar la actualización. Puede reducir la escala una vez finalizada la actualización.

Instancia Índices máximos para MVU

db.t4g.medium

3,000

db.t3.medium

10,000
Grupo de parámetros: se recomienda tener listo un grupo de parámetros de clúster personalizado para la versión de destino antes de la actualización. Si no se especifica ninguno, se utilizará el grupo de parámetros predeterminado para la versión de destino (por ejemplo, default.docdb5.0 odefault.docdb8.0).
Instantánea manual: cree una instantánea manual antes de la actualización. El proceso de actualización crea una instantánea automática con el nombrepreupgrade-<name>-<version>-<timestamp>, pero le recomendamos encarecidamente que tenga su propia copia de seguridad. Consulte Creación de una instantánea manual del clúster.

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.

Instancia	Índices máximos para MVU
db.t4g.medium	3,000
db.t3.medium	10,000

Prácticas recomendadas

Antes de la actualización: realice pruebas con un clon

Clonación de un volumen de clúster de base de datos de Amazon DocumentDBÚselo para crear un clon de su clúster. No incurrirá en costes de almacenamiento a menos que modifique los datos del clon.
Haga coincidir el número de instancias del clon con el clúster de destino para obtener una estimación de tiempo realista.
Realiza la MVU en el clon y comprueba exhaustivamente las diferencias funcionales.
Compruebe si ya hay una actualización programada ejecutando describe-db-clustersy buscandoPendingModifiedValues.EngineVersion. Si ha modificado el clúster y ha seleccionado aplicarlo en la siguiente ventana de mantenimiento, la programación no estará visible en la consola, pero podrá verla en AWS CLI:
```
aws docdb describe-db-clusters \
  --region us-east-1 \
  --db-cluster-identifier mydocdbcluster
```
```
"PendingModifiedValues": {
    "EngineVersion": "5.0.0"
},
```
Si las pruebas se realizan correctamente, continúe con la actualización del clúster de producción.

Durante la actualización

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 base 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 upgrading aavailable.

Durante la actualización se generan los siguientes eventos:

Se inició la actualización de la versión principal del motor del clúster de bases de datos. El clúster permanece en línea.
Preparación de la actualización en curso: se están iniciando las comprobaciones previas de la actualización en línea.
Preparación de la actualización en curso: se han completado las comprobaciones previas de la actualización en línea.
Al desconectar el clúster de base de datos mientras la instancia principal se completa el patch/upgrade proceso.
Preparación de la actualización en curso: se están iniciando las comprobaciones previas de la actualización sin conexión.
Preparación de la actualización en curso: se han completado las comprobaciones previas de la actualización sin conexión.
<version-to><timestamp>Actualización en curso: creación de una instantánea previa a la actualización [preupgrade- <cluster-name>- <version-from>-to- -].
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 están visibles en la consola, en la página de eventos:

Imagen: cuadro de navegación de eventos que muestra una tabla de eventos de actualización.

Desde el AWS CLI, puede ejecutar aws docdb describe-eventspara supervisar el progreso de la actualización. Para recibir notificaciones automáticamente, suscríbase aws docdb create-event-subscriptiona eventos y envíelos a Amazon SNS para recibir correos electrónicos, mensajes push u otros métodos de entrega. Para obtener más información, consulte Suscripción a eventos de Amazon DocumentDB.


aws docdb describe-events 
  --source-identifier mydocdbcluster 
  --source-type db-cluster

El comando devuelve un resultado similar al siguiente:


{
    "Events": [
        {
            "SourceIdentifier": "mydocdbcluster",
            "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 la actualización

aviso

Inmediatamente después de la actualización de la versión principal, el clúster de Amazon DocumentDB rellena los metadatos del índice que el motor de base de datos utiliza para optimizar los planes de ejecución de consultas. El rendimiento de las consultas vuelve a los niveles esperados una vez finalizado este proceso. Por lo general, finaliza en unos minutos, pero puede tardar hasta dos horas, según la cantidad de índices del clúster.

No reinicie, realice una conmutación por error ni up/down escale la instancia de grabación durante este tiempo, ya que podría interrumpir el recálculo de los metadatos del índice. Se recomienda esperar a observar el rendimiento esperado de las consultas antes de realizar dichos cambios.

Realice un seguimiento del progreso mediante los siguientes eventos del clúster:

Post-upgrade estado del clúster: se inició el proceso de actualización de los metadatos del índice
Post-upgrade estado del clúster: el proceso de actualización de los metadatos del índice se completó en X segundos

Póngase en contacto con el servicio de AWS asistencia si el proceso de actualización de los metadatos del índice no se ha completado en tres horas o si sigue teniendo problemas de rendimiento una vez finalizado el proceso.

Realice una instantánea manual del clúster actualizado en caso de que necesite restaurarlo 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 de la versión principal local.
Los clústeres de etiquetas se actualizaron desde la versión 3.6. Agregue una etiqueta para diferenciar los clústeres actualizados desde la versión 3.6. (consultePost-upgrade consideraciones sobre los clústeres actualizados desde la versión 3.6 o 4.0).
Actualice el controlador. Para usar nuevas funciones (por ejemplo, intercalación, vistas o compresión Zstd en 8.0), actualice a la versión de la API de MongoDB correspondiente. Para obtener más información, consulte Novedades en Amazon DocumentDB 8.0.
Realice una prueba exhaustiva. Valide su aplicación con el clúster actualizado.

Qué cambia tras la actualización de Amazon DocumentDB 5.0 a 8.0

Tras realizar una actualización de la versión principal de Amazon DocumentDB 5.0 a 8.0, se habilitan o modifican las siguientes funciones:

Intercalación. Amazon DocumentDB 8.0 admite la intercalación. Tras la actualización, las colecciones nuevas y sus índices, y los nuevos índices de las colecciones existentes, tienen habilitada la intercalación de forma predeterminada.
Índice de texto. Los nuevos índices de texto se crean con Text Index V2, que utiliza un analizador de búsqueda de texto actualizado para mejorar la compatibilidad con MongoDB. Los índices de texto existentes no se ven afectados.
Versión del planificador de consultas. Si no tenía un grupo de parámetros personalizado, se crea un nuevo grupo de parámetros predeterminado para Amazon DocumentDB 8.0 con la versión 3 de Planner seleccionada automáticamente. Con la versión 3 del planificador de consultas, también están disponibles las vistas.
Compresión. Amazon DocumentDB 8.0 admite la compresión de documentos basada en diccionarios mediante el algoritmo Zstd. Tras la actualización, se crean nuevas colecciones con la compresión Zstd habilitada de forma predeterminada. Las colecciones existentes de la versión 5.0 conservan su configuración de compresión. Para aprovechar la compresión de Zstd en las colecciones existentes, puedes modificar sus ajustes de compresión. Para obtener más información, consulte Dictionary-based compresión.
Reconstrucción del índice. Si va a actualizar de Amazon DocumentDB 5.0 a Amazon DocumentDB 8.0, no es necesario reconstruir el índice.

nota

Para obtener una lista completa de las diferencias funcionales, consulte. Compatibilidad de Amazon DocumentDB con MongoDB

Post-upgrade consideraciones sobre los clústeres actualizados desde la versión 3.6 o 4.0

Reconstrucción del índice. Una MVU conserva los índices originales. Amazon DocumentDB 5.0 ha mejorado el mantenimiento de los índices y la recopilación de elementos no utilizados, especialmente para los índices de baja cardinalidad. Tras la actualización desde la versión 3.6 o la 4.0, le recomendamos que vuelva a crear los índices para garantizar un rendimiento óptimo de las consultas (opcional, implica opciones adicionales). I/O Consulte Mantenimiento de índices mediante reIndex.
Comparación numérica de subdocumentos (solo 3.6). Los clústeres actualizados desde la versión 3.6 heredan el comportamiento de la versión 3.6, en el que los tipos numéricos de los subdocumentos no se comparan entre sí. Por ejemplo, {a: {b: NumberLong(1)}} no es igual {a: {b: 1}} en 3.6, pero son iguales en 4.0 y versiones posteriores. Este comportamiento afecta a todos los clústeres actualizados desde la versión 3.6.

Aplicación de la actualización

Resolución de problemas

Error de actualización y reversión. Si la actualización falla, intentará revertirla automáticamente. Una reversión correcta genera el evento: «El clúster de base de datos está en un estado que no se puede actualizar». El clúster vuelve a su estado anterior a la actualización y puede seguir utilizándolo. Ponte en contacto con AWS el servicio de asistencia para solucionar el problema antes de volver a intentarlo.
Post-upgrade rendimiento. Es posible que se produzca una degradación temporal del rendimiento y un uso elevado de la CPU mientras se ejecuta la actualización de los metadatos del índice. Si la degradación persiste más de 3 horas, póngase en contacto con el servicio de AWS asistencia.

Para obtener asistencia adicional, ponte en contacto con AWS Support.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Fechas de soporte de la versión del motor

Actualización mediante AWS DMS