Advertencia
Limitaciones de versiones pasadas
Las advertencias críticas que se mencionan a continuación afectan a algunos sistemas anteriores. mongosync
versiones. Actualiza a la última versión disponible del parche.
Problema | Versiones afectadas |
|---|---|
| 1.5.0 - 1.7.1 |
| 1.1.0 - 1.7.1 |
Versiones de parches
1.7.3 Versión
4 de junio de 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.
Error corregido introducido en la versión1.0.0 donde mongosync podría omitir eventos de cambio para un documento. Este es un caso extremo poco probable que solo es posible si la versión del servidor de destino es MongoDB 5.0 o anterior.
Se corrigió un error introducido en v1.7.0 que podría resultar en discrepancias de tamaño entre las colecciones limitadas de origen y destino. Esto solo puede afectar las migraciones si se cumplen todas las siguientes condiciones:
El cluster 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 con tamaño fijo fue modificado durante una migración.
Error corregido introducido en la versión1.0.0 donde mongosync ignoró el campo
changeStreamPreAndPostImagesen los eventos de cambiomodify. Esto podría dar lugar a que una colección de destino tenga un valor diferente para este campo en comparación con su colección de origen. mongosync ahora gestiona correctamente este campo.Error mitigado introducido en la versión1.0.0 que podría resultar en eventos de cambio perdidos cuando mongosync se interrumpe y reanuda. Este es un caso límite poco probable.
Otros cambios:
Agrega un retraso de dos minutos al reiniciar y reanudar las operaciones de sincronización.
Limitaciones:
Debes detener el balanceador tanto en los clústeres fragmentados de origen como de destino durante toda la vida útil de una migración. Si intentas iniciar mongosync mientras el balanceador aún está funcionando, aparecerá un error.
No debes ejecutar los comandos
moveChunkomoveRangeen el clúster de destino. Si intentas ejecutar estos comandos en el clúster de origen, mongosync genera un error.mongosync lee del clúster de destino utilizando la preferencia de lectura
primary. Si intentas iniciar mongosync con una preferencia de lectura diferente, arrojará un error.
1.7.2 Versión
abril 4, 2024
Problemas corregidos:
Se corrigió el error introducido en la v1.5.0 donde mongosync podría perder eventos de cambio al leer documentos desde un secundario rezagado al desactivar el mecanismo de resiliencia al rollover del Oplog.
Se ha corregido un error introducido en la v1.1.0. donde mongosync podría omitir la copia de documentos durante largas lecturas en la fase inicial de copia si el clúster de origen está particionado y el balanceador de origen está habilitado.
Se corrigió un error introducido en la v1.5.0 que podría resultar en inconsistencias de datos si mongosync se detiene o pausa durante la fase inicial de copia de la colección y luego se reanuda.
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 restringidas y el clúster de destino ejecuta MongoDB 6.0 o posterior.
Error corregido introducido en la versión1.0.0 donde se podrían crear índices en el clúster de destino que se eliminaron 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 la versión1.0.0 que podría provocar que se creen colecciones en el clúster de destino con tipos, opciones o índices incorrectos.
Esto solo puede afectar las migraciones cuando las colecciones se eliminan o renombran mientras mongosync está en ejecución 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 solucionó un error introducido en la versión1.1.0 que podría causar una caída de mongosync si los índices de clave de partición en el clúster de origen presentan valores inconsistentes en las particiones para la opción de creación de índices "en segundo plano".
Esto solo puede afectar las migraciones que involucren colecciones fragmentadas y clústeres de origen anteriores a MongoDB 6.0.
Otros cambios:
Deshabilita el mecanismo de resiliencia de 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 del clúster de origen usando el
primarypreferencia de lectura. Si intentas iniciar mongosync con una preferencia de lectura diferente, arrojará un error.Debes detener el balanceador en un clúster de origen particionado hasta que mongosync termine la fase de copia de la colección. Si intentas iniciar mongosync mientras el balanceador aún se está ejecutando, se lanzará un error.
No debes ejecutar los comandos
moveChunkomoveRangeen el clúster de origen. Si se ejecutan en el clúster de origen, mongosync arroja un error.
Versión 1.7.1
09 de noviembre de 2023
Problemas corregidos:
Se corrigió un error que provocaba que mongosync se bloqueara al intentar actualizar en vivo desde la versión 1.6. El error no implica modificar los datos del usuario y no impide que la sincronización continúe usando la versión 1.7.1.
1.7.0 Lanzamiento
18 de octubre de 2023
Actualización en vivo
A partir de mongosync 1.7.0, puedes 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 saber si puedes realizar una actualización en vivo a una versión específica, verifica la
notas de versión y consulta la sección Actualizaciones en vivo.
Sincroniza datos entre clústeres con diferentes versiones principales de MongoDB Server
A partir de 1.7.0, mongosync puede realizar la migración de versión de determinados clústeres de origen de una versión principal inferior a determinados clústeres de destino de una versión principal superior.
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 hacer que ORR insertara documentos en una colección con tamaño fijo fuera de orden. Es decir, los documentos en el clúster de origen y el de destino pueden no eliminarse de la colección con tamaño fijo en el mismo orden. Este error solo se activa si se insertan documentos en una colección con tamaño fijo durante la migración, antes o mientras la fase de Copia de Colección está trabajando en la misma colección con tamaño fijo.Se corrigió un error introducido en la versión 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, actualiza tus clústeres de origen y destino a la versión más reciente del parche de MongoDB Server antes de la migración. Para más información, consulte Actualice a la última versión parche autogestionada de MongoDB.