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.
**Topics**
+ [Rutas de actualización admitidas](#mvu-upgrade-paths)
+ [Requisitos previos](#mvu-prerequisites)
+ [Prácticas recomendadas](#mvu-best-practices)
+ [Qué cambia tras la actualización a Amazon DocumentDB 8.0](#mvu-50-to-80-differences)
+ [Post-upgrade consideraciones para los clústeres actualizados desde la versión 3.6 o 4.0](#mvu-36-to-50-differences)
+ [Aplicación de la actualización](#perform-an-mvu)
+ [Resolución de problemas](#mvu-troubleshooting)
## 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](#mvu-36-to-50-differences) posteriores a la actualización. |
| Amazon DocumentDB 3.6 | Amazon DocumentDB 8.0 (cualquier versión secundaria publicada) | Consulte [Post-upgrade consideraciones para los clústeres actualizados desde la versión 3.6 o 4.0](#mvu-36-to-50-differences) y [Qué cambia tras la actualización a Amazon DocumentDB 8.0](#mvu-50-to-80-differences) para conocer las consideraciones 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](#mvu-36-to-50-differences) posteriores a la actualización. |
| Amazon DocumentDB 4.0 | Amazon DocumentDB 8.0 (cualquier versión secundaria publicada) | Consulte [Post-upgrade consideraciones para los clústeres actualizados desde la versión 3.6 o 4.0](#mvu-36-to-50-differences) y [Qué cambia tras la actualización a Amazon DocumentDB 8.0](#mvu-50-to-80-differences) para conocer las consideraciones 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 a Amazon DocumentDB 8.0](#mvu-50-to-80-differences) para ver los cambios en las funciones. |
Para ver las versiones secundarias disponibles en su AWS región, utilice el AWS CLI comando`aws docdb describe-db-engine-versions`. Para obtener una lista de las versiones secundarias publicadas, consulte[Notas de la versión](release-notes.md).
**nota**
Cada MVU puede segmentar 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 u 8.0 más reciente publicada; no es necesario actualizar primero a la versión `.0` secundaria y, a continuación, aplicar una actualización a la versión secundaria.
Puede actualizar de Amazon DocumentDB 3.6 o 4.0 directamente a la 8.0 en una sola MVU. También se admite la actualización por etapas hasta la 5.0 (primero a una versión secundaria 5.0 y luego a una versión secundaria 8.0).
**nota**
In-place 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 secundarios. Para ver los pasos detallados, consulte [Eliminación de un clúster global de Amazon DocumentDB](global-clusters.manage.md#global-clusters.remove).
## 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` o`db.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íficamente`binData`, los alias`bool`,`date`, `double``decimal`, 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 más recientes antes de `db.r5.*` actualizarlas. Consulte [Modificación de una instancia de base de datos de Amazon DocumentDB](db-instance-modify.md) y [Clases de instancias admitidas por región](db-instance-classes.md#db-instance-classes-by-region).
+ **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](db-instance-maintain.md#os-system-updates).
**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](db-cluster-version-upgrade.md).
+ **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.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/documentdb/latest/devguide/docdb-mvu.html)
+ **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.0` o`default.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---`, pero siempre crea tu propia copia de seguridad. Consulte [Creación de una instantánea manual del clúster](backup_restore-create_manual_cluster_snapshot.md).
**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
1. [Clonación de un volumen de clúster de base de datos de Amazon DocumentDB](db-cluster-cloning.md)Utilízalo para crear un clon de tu clúster. No incurrirás en costos de almacenamiento a menos que modifiques los datos del clon.
1. Haga coincidir el recuento de instancias del clon con el clúster de destino para obtener una estimación temporal realista.
1. Realice la MVU en el clon y compruebe completamente las diferencias funcionales.
1. Para comprobar si ya hay una actualización programada, ejecute [`describe-db-clusters`](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-db-clusters.html) y 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 \
--region {{us-east-1}} \
--db-cluster-identifier {{mydocdbcluster}}
```
```
"PendingModifiedValues": {
"EngineVersion": "5.0.0"
},
```
1. 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` a`available`.
Durante la actualización se generan los siguientes eventos:
1. 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.
1. Preparación de la actualización en curso: se están iniciando las comprobaciones previas de la actualización en línea.
1. Preparación de la actualización en curso: se han completado las comprobaciones previas de la actualización en línea.
1. Desconectar el clúster de bases de datos mientras la instancia principal completa el patch/upgrade proceso.
1. La preparación de la actualización está en curso: al iniciar la actualización sin conexión se realizan comprobaciones previas.
1. Preparación de la actualización en curso: se han completado las comprobaciones previas a la actualización sin conexión.
1. Actualización en curso: creación de una instantánea previa a la actualización [preupgrade- - -to- -].
1. Actualización en curso: volumen de clonación.
1. Actualización en curso: actualización del escritor.
1. Actualización en curso: actualización de los lectores.
1. 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-events`](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-events.html) para supervisar el progreso de la actualización. Para recibir notificaciones automáticamente, utilice la opción [`aws docdb create-event-subscription`](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-event-subscription.html) para suscribirse a los eventos y enviarlos 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](event-subscriptions.subscribe.md).
```
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 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.
1. **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.
1. **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. (consulte[Post-upgrade consideraciones para los clústeres actualizados desde la versión 3.6 o 4.0](#mvu-36-to-50-differences)).
1. **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](compatibility.md#compatibility-whatsnew-8).
1. **Pruébelo minuciosamente. ** Valide su aplicación con el clúster actualizado.
## Qué cambia tras la actualización a Amazon DocumentDB 8.0
Tras realizar una actualización de la versión principal a Amazon DocumentDB 8.0 (desde Amazon DocumentDB 5.0 o directamente desde la 3.6 o la 4.0), 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](collation.md) 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 ](views.md) 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](dict-compression.md).
+ **Reconstrucción del índice. ** Si va a actualizar de Amazon DocumentDB 5.0 a Amazon DocumentDB 8.0, no es necesario reconstruir el índice. Si va a actualizar directamente de Amazon DocumentDB 3.6 o 4.0 a 8.0, reconstruya los índices tal y como se describe en. [Post-upgrade consideraciones para los clústeres actualizados desde la versión 3.6 o 4.0](#mvu-36-to-50-differences)
**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](compatibility.md)
## 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 y versiones posteriores han mejorado el mantenimiento de los índices y la recolección de basura, especialmente para los índices de baja cardinalidad. Tras actualizar la versión 3.6 o 4.0 (a la 5.0 o la 8.0), reconstruya los índices para garantizar un rendimiento óptimo de las consultas (opcional, implica un adicional). I/O Consulte [Mantenimiento de índices mediante ReIndex ``](managing-indexes.md#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
------
#### [ Using the Consola de administración de AWS ]
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) de Amazon DocumentDB y ábrala.
1. En la ** tabla ** Clústeres, seleccione el clúster de origen, elija ** Acciones y**, a continuación, ** Modificar**.
1. En las especificaciones del ** clúster**, elija la versión de destino (por ejemplo, ** 5.0.0 ** u ** 8.0.0**) en el menú desplegable de versiones ** del ** motor.
1. En las opciones ** del clúster**, selecciona el grupo de parámetros del clúster para la versión del motor de destino. Puedes usar el grupo de parámetros predeterminado (por ejemplo, ** default.docdb5.0 ** o ** default.docdb8.0**) o un grupo de parámetros personalizado que hayas creado.
1. Elija ** Continuar**, seleccione su preferencia de programación (aplicar inmediatamente o en el siguiente período de mantenimiento) y, a continuación, seleccione Modificar clúster. ** **
1. Supervise el estado del clúster en la tabla de clústeres a medida que pasa a ** actualizarse**:
------
#### [ Using the AWS CLI ]
[`modify-db-cluster`](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/modify-db-cluster.html)Utilízalo con la `--allow-major-version-upgrade` bandera:
```
aws docdb modify-db-cluster \
‐‐db-cluster-identifier {{mydocdbcluster}} \
‐‐allow-major-version-upgrade \
‐‐engine-version {{8.0.0}} \
‐‐apply-immediately \
‐‐cluster-parameter-group {{mydocdbparametergroup}} \
‐‐region {{us-east-1}}
```
Sustituya cada {{placeholder}} una por la información de su clúster.
------
## 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 más 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, consulte[Requisitos previos](#mvu-prerequisites).
+ **Fallo de actualización y reversión. ** Si se produce un error en la actualización, 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](https://aws.amazon.com/support)