Advertencia
Limitaciones de versiones pasadas
Los avisos críticos a continuación afectan a algunos anteriores mongosync
Versiones. Actualice a la última versión de parche disponible.
Problema | Versiones afectadas |
|---|---|
| 1.5.0 - 1.7.1 |
| 1.1.0 - 1.7.1 |
Versiones de parches
1.7.3 Liberación
Junio 4 , 2024
Problemas corregidos:
Error corregido introducido en la v1.0.0 donde el destino puede tener índices faltantes o extra después de que mongosync se confirma. Este es un caso límite poco probable.
Se corrigió un error introducido en la versión1.0.0 que permitía a mongosync omitir eventos de cambio en un documento. Este es un caso excepcional que solo es posible si la versión del servidor de destino es MongoDB 5.0 o anterior.
Se corrigió un error introducido en la versión 68001.7.0 que podía provocar discrepancias de tamaño entre las colecciones limitadas de origen y destino. Esto solo afecta a las migraciones si se cumplen todas las condiciones siguientes:
El clúster de origen es MongoDB 6.0 o anterior.
El clúster de destino es MongoDB 7.0 o posterior.
El tamaño de una colección limitada se modificó durante una migración.
Se corrigió un error introducido en la versión1.0.0 6800 donde Mongosync ignoraba el
changeStreamPreAndPostImagescampo en losmodifyeventos de cambio. Esto podía provocar que una colección de destino tuviera un valor diferente para este campo en comparación con su colección de origen. Mongosync ahora gestiona este campo correctamente.Se mitigó un error introducido en1.0.0 la versión 6800 que podía provocar la omisión de eventos de cambio al interrumpir y reanudar mongosync. Este es un caso excepcional poco probable.
Otros cambios:
Agrega un retraso de dos minutos al reiniciar y reanudar las operaciones de sincronización.
Limitaciones:
Debe detener el balanceador en los clústeres fragmentados de origen y destino durante toda la vida útil de una migración. Si intenta iniciar mongosync mientras el balanceador aún está en ejecución, se generará un error.
No debe ejecutar los comandos
moveChunknimoveRangeen el clúster de destino. Si intenta ejecutarlos en el clúster de origen, mongosync generará un error.Mongosync lee desde el clúster de destino con la preferencia de lectura
primary. Si intenta iniciar Mongosync con una preferencia de lectura diferente, se generará un error.
1.7.2 Liberación
Abril 4 , 2024
Problemas corregidos:
Se corrigió un error introducido en v1.5.0 donde mongosync podía perder eventos de cambio al leer documentos desde un nodo secundario rezagado al deshabilitar el mecanismo Oplog Rollover Resilience.
Se corrigió un error introducido en v1.1.0 donde mongosync podía no copiar documentos durante lecturas de larga duración en la fase de copia inicial si el clúster de origen está fragmentado y el balanceador de origen está habilitado.
Se corrigió un error introducido en v1.5.0 que podía generar inconsistencias en los datos cuando se cancelaba o pausaba mongosync durante la fase inicial de copia de recopilación y luego se reanudaba.
Esto solo puede afectar a las migraciones si:
La migración incluye tipos _id mixtos y el clúster de destino ejecuta MongoDB 4.4 o anterior.
La migración incluye colecciones limitadas y el clúster de destino ejecuta MongoDB 6.0 o posterior.
Se corrigió un error introducido en v1.0.0 donde se podían crear índices en el clúster de destino que se descartaban en el clúster de origen durante la migración.
Esto solo puede afectar migraciones donde el índice dado se crea y se descarta mientras mongosync está en ejecución.
Se corrigió un error introducido en v1.0.0 que podía provocar que se crearan colecciones en el clúster de destino con tipos, opciones o índices incorrectos.
Esto solo puede afectar a las migraciones en las que se eliminan o cambian de nombre las colecciones mientras mongosync se está ejecutando y el clúster de origen o destino ejecuta MongoDB 6.0.0 a 6.0.12 o MongoDB 7.0.0 o 7.0.3.
Se corrigió un error introducido en v1.1.0 que podía provocar un bloqueo de mongosync si los índices de clave de fragmento en el clúster de origen tenían valores inconsistentes en los fragmentos para la opción de creación de índice "en segundo plano".
Esto solo puede afectar a las migraciones que involucran colecciones fragmentadas y clústeres de origen más antiguos que MongoDB 6.0.
Otros cambios:
Desactiva el mecanismo de resiliencia ante rollover de Oplog.
No se permite la actualización en vivo a mongosync 1.7.2.
Reduce la latencia de la API de mongosync.
Limitaciones:
mongosync debe leer desde el clúster de origen utilizando el
primaryPreferencia de lectura. Si intenta iniciar MongoSync con una preferencia de lectura diferente, se generará un error.Debe detener el balanceador en un clúster de origen fragmentado hasta que Mongosync finalice la fase de copia de la colección. Si intenta iniciar Mongosync mientras el balanceador aún está en ejecución, se generará un error.
No debe ejecutar los
moveChunkmoveRangecomandos ni en el clúster de origen. Si se ejecutan en el clúster de origen, mongosync generará un error.
1.7.1 Liberación
noviembre 9 , 2023
Problemas corregidos:
Se corrigió un error que causaba el bloqueo de mongosync al intentar actualizar en vivo desde la versión 1.6. Este error no modifica los datos del usuario ni impide que la sincronización continúe con la versión 1.7.1.
1.7.0 Liberación
octubre 18 , 2023
Actualización en vivo
A partir de mongosync 1.7.0, puede actualizar mongosync sin reiniciar las operaciones de sincronización de datos desde el principio.
Importante
mongosync No admite actualizaciones en vivo a todas las versiones. Para ver si puede actualizar en vivo a una versión específica, consulte la información de esa versión.
notas de la versión y consulte la sección Actualizaciones en vivo.
Sincronizar datos entre clústeres con diferentes versiones principales del servidor MongoDB
A partir de 1.7.0, mongosync puede realizar la migración de versiones desde ciertos clústeres de origen con versiones principales inferiores a ciertos clústeres de destino con versiones principales superiores.
Otras notas
Nuevas características:
mongosyncahora trunca los campos registrados que contienen más de 1,024 caracteres.
Problemas corregidos:
Se corrigió un error introducido en
mongosync1.5.0 que podía provocar que ORR insertara documentos de colecciones limitadas desordenadamente. Es decir, los documentos del clúster de origen y de destino podrían no eliminarse de la colección limitada en el mismo orden. Este error solo se activa si se insertan documentos en una colección limitada durante la migración, antes o durante la fase de copia de colección.Se corrigió un error introducido en 1.6 que causaba que
mongosyncfallara durante la inicialización si el usuario especificaba solo un filtro de exclusión y no había bases de datos completamente excluidas.
Versión mínima compatible
En 1.7.3, la versión mínima compatible de MongoDB es 6.0.13 y 7.0.6.
Para obtener el mejor rendimiento, actualice sus clústeres de origen y destino a la última versión del parche de MongoDB Server antes de la migración. Para obtener más información, consulte Actualizar a la última versión del parche autogestionado de MongoDB.