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.

• 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.

• Before you attempt to run mongosync with an M10+ Atlas cluster, disable the Require Indexes for All Queries option to set notablescan to false on both the source and destination clusters.

• mongosync no sincroniza usuarios ni roles.

• mongosync does not replicate applyOps operations made on the source cluster during sync to the destination cluster.

• mongosync must read from the source cluster using the primary read preference.

• 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.

• En todas las versiones de MongoDB anteriores a 8.0.20, si una operación replace añade un campo llamado $v a un documento, el proceso mongosync arroja un error fatal irrecuperable durante la aplicación del evento de cambio. Reanudar la sincronización siempre falla con el mismo error.

  Para resolver este problema, reinicia la sincronización desde cero, borrando la base de datos de metadatos de mongosync en el destino, o actualiza el clúster de origen a 8.0.20+.

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.

• The movePrimary command cannot be used to reassign the primary shard while syncing.

• 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.

• Si el clúster de origen o destino es un clúster fragmentado y no está ejecutando mongosync con filtrado de espacio de nombres, debe deshabilitar el balanceador del clúster de origen ejecutando el comando y balancerStop esperando 15 minutos para que el comando se complete.

  Si el clúster de origen o destino es un clúster fragmentado y está ejecutando mongosync con filtrado de espacios de nombres, puede habilitar globalmente el equilibrador del clúster de origen, pero debe desactivarlo para todas las colecciones dentro del filtro de espacios de nombres. Consulta Cómo desactivar el balanceador para colecciones en sincronización filtrada. También se puede deshabilitar completamente el balanceador del clúster de origen.

  You must always disable the balancer on a sharded destination cluster by using balancerStop.

• If you have enabled the source cluster's balancer, but disabled it for collections within the namespace filter, do not run shardCollection on collections within the namespace filter. If you run shardCollection on collections within the namespace filter during the migration, mongosync returns an error and stops, which requires you to start the migration from scratch.

• mongosync doesn't support running the command transitionFromDedicatedConfigServer during execution.

• You must not run the moveChunk and moveRange commands on the source or destination clusters.

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

• The reshardCollection operations from the source cluster are not supported during sync.

• 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 no admite colecciones con una intercalación no por defecto en clústeres sharded. Esto aplica tanto a colecciones particionadas como unsharded.

• mongosync errores en los índices que son inconsistentes o faltan en algunas particiones que contienen datos.

• mongosync falla si hay una ventana de balanceo configurada en el clúster de origen o destino.

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.

• In order to reverse direction, mongosync requires that all unique indexes on the source cluster (except for _id) do not have legacy unique index keys.

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 a menos que establezca el parámetro preExistingDestinationData en true al llamar a /start.

• 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.

• To use the $out aggregation stage or the mapReduce command (when set to create or replace a collection) with filtering, you must configure the filter to use the entire database. You cannot limit the filter to collections within the database.

  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 is not supported. If you run convertToCapped, mongosync exits with an 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.

If you issue a dropDatabase command on the source cluster, this change is not directly applied on the destination cluster. Instead, Mongosync drops user collections and views in the database on the destination cluster, but it does not drop system collections on that database.

Por ejemplo, en el clúster de destino:

• The drop operation does not affect a user-created system.js collection.

• If you enable profiling, the system.profile collection remains.

• If you create views on the source cluster and then drop the database, replicating the drop removes the views, but leaves an empty system.views collection.

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.

Creación de índices

When buildIndexes is set to "afterDataCopy", mongosync might fail to apply Rename DDL events. If this occurs, restart the migration from scratch with buildIndexes set to "beforeDataCopy" or "never". Setting buildIndexes to beforeDataCopy can increase the migration time, and setting buildIndexes to never requires you to build indexes manually after the migration completes.

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:

• The source cluster cannot have orphaned documents. To clean up any orphaned documents, run the cleanupOrphaned command on the mongod instances on every shard's primary node on their source cluster. Wait for this command to complete with a status {ok:1} before starting the migration.

• 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

  This includes operations that may create new collections such as mapReduce, $out, and $merge. This also includes collections created implicitly from inserts. Only writes that produce CRUD events can occur during the migration.

  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.