movePrimaryEn un clúster fragmentado,
movePrimaryreasigna el fragmento principal que contiene todas las colecciones no fragmentadas de la base de datos. primero modifica el fragmento principal en los metadatos delmovePrimaryclúster y luego migra todas las colecciones no fragmentadas al fragmento especificado. Use el comando con el siguiente formato:db.adminCommand( { movePrimary: <databaseName>, to: <newPrimaryShard> } ) Por ejemplo, el siguiente comando mueve la partición primaria de
testashard0001:db.adminCommand( { movePrimary : "test", to : "shard0001" } ) Cuando el comando regresa, la ubicación del fragmento principal de la base de datos se ha cambiado al fragmento especificado. Para desmantelar completamente un fragmento, use el
removeShardcomando.movePrimaryes un comando administrativo que solo está disponible paramongosinstancias.Advertencia
Después de
movePrimaryiniciar,no realice ninguna operación de lectura ni escritura en ninguna colección no fragmentada de esa base de datos hasta que se complete el comando. Las operaciones de lectura o escritura realizadas en esas colecciones durante la migración pueden provocar un comportamiento inesperado, como un posible fallo de la migración o la pérdida de datos.
Compatibilidad
Este comando está disponible en implementaciones alojadas en los siguientes entornos:
MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube
MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.
Considerations
mongos usa para escribir "majority" preocupación movePrimary por.
Colecciones no particionadas
EjecutemovePrimarysolo después de mover colecciones no fragmentadas usandosh.moveCollection(). A partir de MongoDB 8.0, las colecciones no fragmentadas y no movidas no están disponibles durante el proceso movePrimary.
Windows de mantenimiento
movePrimary puede requerir un tiempo significativo para completarse dependiendo del tamaño de la base de datos y factores como la salud de la red o los recursos de la máquina. Durante la migración, los intentos de guardar o realizar cualquier operación DDL en las colecciones no particionadas de la base de datos que se está trasladando fallan con el error: "movePrimary is in progress".
Considere programar una ventana de mantenimiento durante la cual las aplicaciones detengan todas las lecturas y escrituras en el clúster. Emitir movePrimary durante el tiempo de inactividad planificado mitiga el riesgo de encontrar un comportamiento indefinido debido a la intercalación de lecturas o escrituras en las colecciones no fragmentadas de la base de datos.
Conflictos de espacios de nombres
movePrimary Falla si el fragmento de destino contiene un espacio de nombres de colección conflictivo. Por ejemplo:
Un administrador emite
movePrimarypara cambiar el fragmento principal de la base de datoshr.Un usuario o una aplicación emite una operación de guardar en una colección no particionada en
hrmientrasmovePrimaryestá moviendo esa colección. La operación de guardar crea la colección en la partición primaria original.Más tarde, un administrador emite
movePrimarypara restaurar el fragmento primario original de la base de datoshr.movePrimaryfalla debido al espacio de nombres conflictivo que quedó de la operación de escritura entrelazada.
Reconstrucción de índices
Como parte de la operación movePrimary, el fragmento de destino debe reconstruir los índices de las colecciones migradas tras convertirse en el fragmento principal. Esto puede requerir un tiempo considerable, dependiendo del número de índices por colección y de la cantidad de datos a indexar.
Consulte Construcciones de índices en colecciones pobladas para obtener más información sobre el proceso de construcción de índices.
Flujos de cambio
A partir de MongoDB 8.0, movePrimary no invalida las colecciones de eventos que tienen flujos de cambios. Los flujos de cambios pueden seguir leyendo eventos de las colecciones después de que las colecciones se trasladen a una nueva partición.
En versiones anteriores de MongoDB, movePrimary invalida los flujos de cambio de colección y los flujos de cambio no pueden leer eventos de las colecciones.
En todas las versiones de MongoDB, movePrimary actualiza el UUID para colecciones no fragmentadas movidas.
Información Adicional
Consulta remover particiones de un clúster para un procedimiento completo.