Limitaciones

Limitaciones generales

• mongosync no admite actualizaciones de versión de servidor en el lugar que cambian la versión principal o secundaria durante una migración. mongosync sí permite actualizaciones de versiones patch. Para obtener más información, consulta las instrucciones de actualización del servidor.

• El clúster de destino debe estar vacío.

• mongosync no valida que los clústeres o el entorno estén configurados correctamente.

• Otros clientes no deben escribir en el clúster de destino mientras mongosync esté en ejecución.

• Si se desea iniciar el proceso de confirmación y no se ha establecido enableUserWriteBlocking en "sourceAndDestination" al utilizar el punto final start, es necesario impedir la escritura en el clúster de origen antes de iniciar el proceso de confirmación.

• colecciones system.* no se replican.

• No se admiten documentos que tengan nombres de campos que comiencen con el símbolo dólar ($). Consulte Nombres de campos con puntos y signos de dólar.

• Los clústeres sin servidor no son compatibles.

• Un MongoDB Shared nivel no es compatible.

• No se admite Queryable Encryption.

• No se puede sincronizar una colección que tenga un índice único y un índice no único definidos en el mismo campo o campos.

• Antes de intentar ejecutar mongosync con un clúster M10+ Atlas, deshabilita la opción Require Indexes for All Queries.

• mongosync no sincroniza usuarios ni roles.

• mongosync no replica operaciones realizadas en el clúster de origen durante la sincronización con el clúster de applyOps destino.

• mongosync debe leer desde el clúster de origen utilizando la primary preferencia de lectura.

• mongosync no admite clústeres de origen o destino que estén actualizando actualmente las versiones de MongoDB.

• mongosync no admite la sincronización de Índices de búsqueda Atlas.

• mongosync solo admite clústeres que utilizan el motor de almacenamiento WiredTiger.

• No puedes sincronizar una colección con ningún documento que tenga una marca de tiempo vacía, como Timestamp(0,0) en versiones anteriores a6.0 clúster de origen.

• mongosync no admite documentos con nombres de campo duplicados. Para más detalles, consulta MongoDB no admite nombres de campos duplicados.

MongoDB Community Edition

MongoDB no prueba Mongosync con Community builds y en la mayoría de los casos, MongoDB no ofrece asistencia para Mongosync con implementaciones de Community. Si deseas usar Mongosync con MongoDB Community Edition, contacta a un representante de ventas de MongoDB para hablar sobre requisitos y opciones individuales.

Tipos de colecciones no permitidos

• No se admiten colección de series de tiempo.

• Las colecciones con índice clusterizado con expireAfterSeconds establecido no son compatibles.

Clústeres fragmentados

• mongosync no admite sincronizar desde un clúster a un set de réplicas.

• mongosync no admite la sincronización con una topología de clúster fragmentado con uno o más árbitros.

• mongosync no soporta la sincronización hacia o desde clústeres globales.

• La sincronización de un set de réplicas a un clúster tiene las siguientes limitaciones:

  • mongosync permite a los usuarios cambiar el nombre de las colecciones que la opción sharding.shardingEntries incluye durante la sincronización con algunas limitaciones. Para más detalles, consulta Renombrar durante la sincronización.

  • Si utilizas la opción sharding.createSupportingIndexes, los índices se crean automáticamente en el clúster de destino durante la sincronización. No se pueden crear estos índices posteriormente en el clúster de origen.

  • Si quieres crear un índice para admitir las claves de partición manualmente, debes crear el índice antes de que mongosync comience o después de que se complete la migración y mongosync se detenga.

• Dentro de una colección, el campo _id debe ser único en todas las particiones del clúster. Consulta Clústeres particionados e índices únicos para obtener más detalles.

• El movePrimary comando no se puede utilizar para reasignar el fragmento principal durante la sincronización.

• No hay replicación para la configuración de zonas. mongosync replica datos, no hereda zonas.

• No se pueden agregar ni eliminar particiones mientras se está sincronizando.

• mongosync solo sincroniza los índices que existen en todas las particiones.

• mongosync solo sincroniza los índices que tienen especificaciones de índice coherentes en todas las particiones.

  Nota

  Para comprobar la existencia de incoherencias de índice, consulte Buscar Índices Inconsistentes en Particiones.

• Debe detener el balanceador en los clústeres de origen y destino fragmentados durante toda la duración de la migración. Para detener el balanceador, ejecute el comando y espere a que balancerStop finalice.

  Nota

  Después de detener el balanceador, espera quince minutos antes de iniciar mongosync. Esto le da al clúster tiempo para finalizar cualquier migración de fragmentos en curso.

• mongosync no admite la ejecución del comando transitionFromDedicatedConfigServer durante la ejecución.

• No debe ejecutar los moveChunk comandos y en los clústeres de origen o destino.moveRange

• La clave de partición no puede ser refinada mientras se está sincronizando.

• Las operaciones del clúster de origen no son compatibles durante la reshardCollection sincronización.

• El número máximo de índices por colección fragmentada 63 es, que es uno menos que el límite predeterminado 64 de.

• mongosync solo admite la sincronización de colecciones particionadas que tienen la configuración por defecto de la intercalación.

Reversión

• Si la fuente anterior tiene índices únicos que están parcialmente distribuidos a través de particiones, revertirlo puede causar fallos. Asegúrese de que existan índices únicos en todas las particiones antes de revertir.

• Los clústeres de origen y destino deben tener el mismo número de particiones. No se puede sincronizar de forma inversa cuando los clústeres tienen diferentes topologías.

• Los clústeres de origen y destino deben ejecutar la misma versión principal de MongoDB.

• Para invertir la dirección, requieremongosync que todos los índices únicos en el clúster de origen _id (excepto) no tengan claves de índice únicas heredadas.

Múltiples clústeres

• mongosync no admite la sincronización de varios clústeres de origen a un clúster de destino.

• Un clúster no puede ser simultáneamente un clúster de origen en una instancia de mongosync y un clúster de destino en otra instancia de mongosync.

Sincronización filtrada

• El filtrado no es compatible con la sincronización reversible.

• El clúster de destino no debe contener datos de usuario antes de comenzar.

• El clúster de destino no debe contener la base de datos del sistema mongosync_reserved_for_internal_use antes de comenzar.

• No puede modificar un filtro que esté en uso. Para crear un nuevo filtro, consulta: Reemplazar un filtro existente.

• Solo puedes renombrar las colecciones en ciertas situaciones. Para más detalles, consulta: Añadir y renombrar colecciones.

• Si un filtro incluye una vista pero no la colección base, sólo los metadatos de la vista se sincronizan con el clúster de destino. Para incluir los documentos de vista, también debe sincronizar la colección base.

• No puedes especificar colección del sistema ni base de datos del sistema en un filtro.

• Para usar la $out etapa de agregación o el comando (cuando mapReduce se configura para crear o reemplazar una colección) con filtrado, debe configurar el filtro para que utilice toda la base de datos. No puede limitar el filtro a colecciones dentro de la base de datos.

  Para obtener más información, consulte Filtrado con mapReduce y $out.

• El filtrado no permite el bloqueo doble de escritura. Puedes utilizar el bloqueo de guardar solo de destino.

Colecciones con tamaño fijo

A partir de 1.3.0, Mongosync admite colecciones con tamaño fijo con algunas limitaciones.

• convertToCapped no es compatible. Si convertToCapped ejecuta, mongosync saldrá con un error.

• cloneCollectionAsCapped no está soportado.

Las colecciones con tamaño fijo en el clúster de origen funcionan con normalidad durante la sincronización.

Las colecciones con tamaño fijo en el clúster de destino tienen cambios temporales durante la sincronización:

• No hay un número máximo de documentos.

• El tamaño máximo de colección es 1PB.

mongosync restaura los valores originales para el número máximo de documentos y el tamaño máximo de documento durante el commit.

Colecciones del sistema

Mongosync no replica las colecciones de sistema en el clúster de destino.

Si se ejecuta el comando en el clúster de origen, este cambio no se aplica directamente en el clúster de destino. En su lugar, Mongosync elimina las colecciones y vistas de usuario en la base de datos del clúster de destino, pero no elimina las colecciones del sistema en dicha base de dropDatabase datos.

Por ejemplo, en el clúster de destino:

• La operación de eliminación no afecta a una colección creada por el usuario.system.js

• Si habilita la creación de perfiles, la colección system.profile permanece.

• Si crea vistas en el clúster de origen y luego elimina la base de datos, al replicar la eliminación se eliminan las vistas, pero queda una colección system.views vacía.

En estos casos, la replicación de dropDatabase elimina todas las colecciones creadas por el usuario de la base de datos, pero deja las colecciones del sistema en el clúster de destino.

MongoDB Atlas Bases de datos internas

mongosync 1.17 y anteriores devuelven un error si el clúster de destino contiene una __mdb_internal_atlas base de datos no vacía. Esta es una base de datos interna utilizada por MongoDB Atlas. Es posible que reciba un error que "found existing data on the destination cluster; the destination cluster must be empty; please drop existing data on the destination and start the migration again" indique.

Para evitar migraciones fallidas, actualice a mongosync 1.18 o posterior, que ignora automáticamente todas las bases de datos internas.

Creaciones de índices continuas

mongosync no admite creación de índices continuos durante la migración. Para evitar crear índices de manera progresiva durante la migración, utiliza uno de los siguientes métodos para asegurarte de que tus índices de destino coincidan con tus índices de origen:

• Construya el índice en la fuente antes de la migración.

• Construye el índice en el origen durante la migración con una creación de índices predeterminada.

• Construye el índice en el destino después de la migración.

Verificador Integrado

A partir de 1.9, mongosync puede utilizar un verificador incrustado para confirmar la sincronización exitosa de las colecciones desde el clúster de origen hasta el clúster de destino.

Configuración de consulta persistente

mongosync no migra la Configuración de query Persistente (PQS), que se introdujo en MongoDB 8.0. Si tu clúster de origen utiliza PQS, debes migrarlos manualmente.

Migraciones pre-6.0

A partir de 1.10, mongosync admite migraciones desde clústeres de origen que ejecutan versiones del servidor de MongoDB anteriores a 6.0. Para obtener información sobre las rutas de migración compatibles, consulte Compatibilidad de versiones de MongoDB Server.

Se aplican las siguientes limitaciones al pre-6.0 migración:

• Las escrituras que producen DDL eventos no pueden ocurrir en el clúster de origen durante la migración. Los siguientes eventos no pueden ocurrir:

  • collMod

  • create

  • createIndexes

  • drop

  • dropDatabase

  • dropIndexes

  • refineCollectionShardKey

  • rename

  • reshardCollection

  • shardCollection

  Esto incluye operaciones que pueden crear nuevas colecciones mapReduce como, y. También incluye colecciones creadas implícitamente a partir de inserciones. Solo se$out $mergepermiten escrituras que generen eventos CRUD durante la migración.

  Nota

  Se permiten escrituras que produzcan eventos DDL en colecciones fuente fuera del filtro de espacio de nombres.

• geoHaystack los índices no son compatibles.

• /reverse el endpoint no es compatible. No puede activar la opción reversible en la solicitud /start.

• No puedes establecer la opción enableUserWriteBlocking en "sourceAndDestination" en la solicitud /start, por lo que el bloqueo dual de escritura no es compatible. Se admite el bloqueo de guardar solo para el destino. Asegúrese de que no se realicen guardados en el clúster de origen después de llamar al punto final /commit.

• No puedes habilitar el parámetro de particionado createSupportingIndexes. En su lugar, crea un índice para admitir tu clave de partición en el clúster de origen.

• Si hay algún índice con especificaciones inconsistentes o que falte en una o más particiones, mongosync devuelve un error. Para comprobar inconsistencias de índices, consulta Buscar índices inconsistentes en las particiones.

• El clúster de origen no puede tener documentos huérfanos. Para eliminar los documentos huérfanos, ejecute el comando en su clúster de cleanupOrphaned origen.