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 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 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:
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 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 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 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 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 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 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 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 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 del clúster de origen usando el
primaryPreferencia de lectura. Si intenta iniciar MongoSync con una preferencia de lectura diferente, se generará 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 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.
Versión 1.7.0
18 de octubre de 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 saber si puedes realizar una actualización en vivo a una versión específica, verifica la
notas de la versión y consulte 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 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.