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
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 todos los Regiones de AWS lugares en los que Amazon DocumentDB esté disponible.
importante
El clúster no está disponible durante la actualización y se reinicia varias veces. No se conecte al clúster, no lea desde él ni escriba en él después de iniciar la actualización. El tiempo de inactividad varía en función del número de recopilaciones, índices, bases de datos e instancias. Realice la actualización durante el período de mantenimiento o durante las horas de baja utilización.
Una vez actualizada, no puede cambiar a una versión anterior. Si es necesario, puede restaurar la instantánea anterior a la actualización en un clúster nuevo.
Temas
Rutas de actualización admitidas
En la siguiente tabla se enumeran todas las rutas de actualización de las versiones principales locales compatibles. Puede seleccionar cualquier versión secundaria publicada en la versión principal de destino como versión del motor de destino.
| Versión principal de origen | Versión principal de destino | Notas |
|---|---|---|
Amazon DocumentDB 3.6 |
Amazon DocumentDB 5.0 (cualquier versión secundaria publicada) |
Consulte las consideraciones Post-upgrade consideraciones para los clústeres actualizados desde la versión 3.6 o 4.0 posteriores a la actualización. |
Amazon DocumentDB 4.0 |
Amazon DocumentDB 5.0 (cualquier versión secundaria publicada) |
Consulte las consideraciones Post-upgrade consideraciones para los clústeres actualizados desde la versión 3.6 o 4.0 posteriores a la actualización. |
Amazon DocumentDB 5.0 (cualquier versión secundaria publicada) |
Amazon DocumentDB 8.0 (cualquier versión secundaria publicada) |
Consulte Qué cambia tras la actualización de Amazon DocumentDB 5.0 a 8.0 para ver los cambios en las funciones. |
Para ver las versiones secundarias disponibles en su AWS región, utilice el AWS CLI comandoaws docdb describe-db-engine-versions. Para obtener una lista de las versiones secundarias publicadas, consulteNotas de la versión.
nota
Cada MVU puede apuntar a cualquier versión secundaria publicada en la versión principal de destino. Por ejemplo, la actualización desde Amazon DocumentDB 3.6 o 4.0 puede ir directamente a la versión secundaria 5.0 más reciente publicada; no es necesario actualizar primero a la 5.0.0 y, a continuación, aplicar una actualización a la versión secundaria.
Para llegar a la versión 8.0 desde la 3.6 o la 4.0, realice dos MVUs: primero a la versión secundaria 5.0 que elija y, a continuación, a la versión secundaria 8.0 que elija. No existe una ruta directa entre las MVU 3.6→8.0 o 4.0→8.0.
nota
In-place La MVU no es compatible con 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 cargos mientras el servidor principal actualizado replica los datos en los nuevos servidores secundarios. Para ver los pasos detallados, consulte Eliminación de un clúster global de Amazon DocumentDB.
Requisitos previos
importante
Amplíe las instancias con ráfagas antes de realizar la actualización. Si tu clúster usa tipos de instancias escalables (por ejemplo, db.t3.medium odb.t4g.medium), amplía la instancia principal al menos db.r5.large o db.r6g.large antes de iniciar la actualización. Es posible que las instancias en ráfagas no tengan suficiente CPU y memoria para completar el proceso de actualización, lo que puede provocar errores en la actualización y una mayor falta de disponibilidad del clúster. Puede reducir la escala una vez finalizada la actualización.
Amplíe la instancia de escritura sin servidor antes de la actualización. Si el clúster tiene una instancia de escritura sin servidor, la DCU máxima del clúster ServerlessV2ScalingConfiguration debe establecerse en 3 o más antes de iniciar la actualización. Los clústeres con una DCU máxima inferior a 3 no se pueden actualizar porque no tienen suficiente CPU o memoria para completar la actualización.
Compruebe los índices parciales antes de realizar la actualización (actualice de Amazon DocumentDB 5.0 a 8.0). Antes de iniciar la actualización, revise sus índices parciales para ver si hay uno partialFilterExpression que utilice el $type operador para coincidir con ciertos tipos de BSON: específicamentebinData, los aliasbool,date, doubledecimal, y array type, o un código de tipo numérico, como. { "$type" : 1 } Estos índices parciales hacen que la actualización falle, aunque el índice funcione normalmente para lectura y escritura. db.collection.getIndexes()Utilícelo para revisar partialFilterExpression los índices parciales. Elimine el índice parcial afectado antes de iniciar la actualización y vuelva a crearlo cuando finalice la actualización. Si no está seguro de si un índice está afectado, póngase en contacto con el servicio de AWS asistencia antes de realizar la actualización.
-
Tipo de instancia: Amazon DocumentDB 4.0+ no admite instancias db.r4. Modifique las instancias para
db.r4.*convertirlas en instancias o versiones posteriores antes de ladb.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: aplica cualquier acción de mantenimiento del sistema operativo pendiente en todas las instancias antes de la actualización. Consulte Actualizaciones del sistema operativo de Amazon DocumentDB.
nota
Los parches pendientes del motor a nivel de clúster pueden ocultar los parches del sistema operativo de la instancia. Aplica 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 para las instancias en ráfagas (instancias de la familia T): si tienes más de 3000 índices en instancias en ráfagas, amplía la instancia principal a al menos db.r5.large antes de actualizarla. Puedes 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: tenga 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.0odefault.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 denominada
preupgrade-<name>-<version>-<timestamp>, pero siempre crea tu 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.
Prácticas recomendadas
Antes de la actualización: prueba con un clon
Clonación de un volumen de clúster de base de datos de Amazon DocumentDBUtilízalo para crear un clon de tu clúster. No incurrirás en costos de almacenamiento a menos que modifiques los datos del clon.
Haga coincidir el recuento de instancias del clon con el clúster de destino para obtener una estimación temporal realista.
Realice la MVU en el clon y compruebe completamente las diferencias funcionales.
Para comprobar si ya hay una actualización programada, ejecute
describe-db-clustersy busque PendingModifiedValues.EngineVersion. Si modificó el clúster y decidió aplicarlo en la siguiente ventana de mantenimiento, la programación no aparecerá en la consola, pero podrá verla en AWS CLI:aws docdb describe-db-clusters \ --regionus-east-1\ --db-cluster-identifiermydocdbcluster"PendingModifiedValues": { "EngineVersion": "5.0.0" },Si la prueba se realiza 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 finalice la actualización, recibirá el mensaje «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 de 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 de 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.
Desconectar el clúster de bases de datos mientras la instancia principal completa el patch/upgrade proceso.
La preparación de la actualización está en curso: al iniciar la actualización sin conexión se realizan comprobaciones previas.
Preparación de la actualización en curso: se han completado las comprobaciones previas a 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:
Desde el AWS CLI, puede ejecutar aws docdb describe-eventsaws docdb create-event-subscription
aws docdb describe-events --source-identifiermydocdbcluster--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 local de la versión principal, su 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, conmute por error ni escale la instancia de up/down escritura durante este tiempo, ya que podría interrumpir el recálculo de los metadatos del índice. Espere hasta que observe el rendimiento esperado de la consulta antes de realizar dichos cambios.
Realice un seguimiento del progreso mediante los siguientes eventos de 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
Ponte 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 sigues teniendo problemas de rendimiento una vez finalizado el proceso.
Realiza una instantánea manual del clúster actualizado en caso de que necesites restaurarlo al estado posterior a la actualización. El proceso de creación automática de instantáneas se reanudará tan pronto como finalice la actualización local de la versión principal.
Clústeres de etiquetas actualizados desde la versión 3.6. Agregue una etiqueta para diferenciar los clústeres actualizados desde la versión 3.6. (consultePost-upgrade consideraciones para los clústeres actualizados desde la versión 3.6 o 4.0).
Actualiza tu controlador. Para usar nuevas funciones (por ejemplo, intercalación, vistas o compresión Zstd en 8.0), actualice a la versión correspondiente de la API de MongoDB. Para obtener más información, consulte Novedades de Amazon DocumentDB 8.0.
Pruébelo minuciosamente. 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 principal de la versión 5.0 a la 8.0 de Amazon DocumentDB, se habilitan o modifican las siguientes funciones:
-
Intercalación. Amazon DocumentDB 8.0 admite la Uso de la intercalación en Amazon DocumentDB 8.0 intercalación. Tras la actualización, las colecciones nuevas y sus índices, así como 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, las vistas también están disponibles.
-
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 Zstd en las colecciones existentes, puede modificar su configuración de compresión. Para obtener más información, consulte Administración de la compresión basada en diccionarios en Amazon DocumentDB 8.0.
-
Reconstrucción del índice. Si va a actualizar de Amazon DocumentDB 5.0 a Amazon DocumentDB 8.0, no es necesario reconstruir el índice.
importante
Amazon DocumentDB 8.0 requiere TLS 1.2 o superior. Ya no se admiten TLS 1.0 y TLS 1.1.
nota
Para obtener una lista completa de las diferencias funcionales, consulte. Compatibilidad de Amazon DocumentDB con MongoDB
Post-upgrade consideraciones para 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 recolección de basura, especialmente para los índices de baja cardinalidad. Tras actualizar desde la versión 3.6 o 4.0, reconstruya los índices para garantizar un rendimiento óptimo de las consultas (opcional, implica un adicional). 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, según el cual los tipos numéricos de los subdocumentos no se comparan entre tipos. Por ejemplo,
{a: {b: NumberLong(1)}}no es igual{a: {b: 1}}en 3.6, pero es igual 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
Pre-upgrade error de comprobación. Antes de que comience la actualización, Amazon DocumentDB ejecuta comprobaciones de validación previas a la actualización. Las siguientes son las causas comunes de errores en las comprobaciones previas:
-
La actualización no pudo continuar porque los nombres de las colecciones tienen 58 caracteres o más. Cambie el nombre de las colecciones afectadas por nombres más cortos antes de volver a intentar la actualización.
-
La actualización no pudo continuar porque el recuento de índices supera el límite establecido para el tipo de instancia. Actualice a un tipo de instancia más grande antes de volver a intentar la actualización. Para ver los límites de índice por tipo de instancia, consulteRequisitos previos.
-
Fallo de actualización y reversión. Si la actualización falla, intentará revertirla automáticamente. Si la reversión se realiza correctamente, se produce el siguiente evento: «El clúster de la base de datos se encuentra 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 durante más de 3 horas, póngase en contacto con el servicio de AWS asistencia.
Para obtener más ayuda, póngase en contacto con. AWS Support
