moveChunk (comando de base de datos)

Definición

moveChunk

Comando administrativo interno. Movimientos chunks between partición. Emita el comando moveChunk a través de una instancia de mongos mientras se utiliza la base de datos admin. Utilice los siguientes formularios:

Tip

En mongosh, este comando también se puede ejecutar a través del método asistente sh.moveChunk().

Los métodos asistente son convenientes para usuarios de mongosh, pero es posible que no proporcionen el mismo nivel de información que los comandos de base de datos. En los casos en que no se necesite la conveniencia o se requieran campos de retorno adicionales, utiliza el comando de base de datos.

db.adminCommand( { moveChunk : <namespace> ,
                 find : <query> ,
                 to : <string>,
                 forceJumbo: <boolean>,
                 _secondaryThrottle : <boolean>,
                 writeConcern: <document>,
                 _waitForDelete : <boolean> } )

Alternativamente:

db.adminCommand( { moveChunk : <namespace> ,
                 bounds : <array> ,
                 to : <string>,
                 forceJumbo: <boolean>,
                 _secondaryThrottle : <boolean>,
                 writeConcern: <document>,
                 _waitForDelete : <boolean> } )

El comando moveChunk tiene los siguientes campos:

Campo	Tipo	Descripción
moveChunk	string	El namespace de la colección donde existe el fragmento. Especifica el namespace completo de la colección, incluyendo el nombre de la base de datos.
find	Documento	Una coincidencia exacta en la clave de partición que especifica el valor de la clave de partición del fragmento a mover. Especifique el campo bounds o el campo find, pero no ambos. No utilice el find campo para seleccionar fragmentos en colecciones que utilicen una clave de partición con hash.
bounds	arreglo	Los límites de un determinado fragmento para mover. El arreglo debe consistir en dos documentos que especifiquen los valores inferior y superior del valor de la clave de partición de un fragmento a mover. Especifica el campo bounds o el campo find, pero no ambos. Utilice bounds para seleccionar fragments en colecciones que utilizan una clave de partición con hash.
to	string	El nombre de la partición de destino para el fragmento.
forzarJumbo	booleano	opcional. Una bandera que determina si el comando puede mover un fragmento que es demasiado grande para migrar. La fragmento puede estar marcada o no como jumbo. Si true, el comando puede mover el fragmento. Si false, el comando no puede mover el fragmento. El valor es por defecto false. ADVERTENCIA: El comando moveChunk con forceJumbo=true bloquea las operaciones de guardado en la colección. Esta opción provoca que la partición migre fragmentos, incluso cuando son más grandes que el tamaño de fragmento configurado. La colección permanece no disponible para guardados durante la migración. Para migrar estos grandes fragmentos sin este largo período de bloqueo, consulta Balancear rangos que exceden el límite de tamaño en su lugar.
_secondaryThrottle	booleano	opcional. Para WiredTiger, por defecto es false. Si true, por defecto, cada movimiento de documento durante la migración de fragmentos se propaga al menos a un secundario antes de que el balanceador continúe con el siguiente documento. Esto es equivalente a un nivel de confirmación de escritura (write concern) de { w: 2 }. Utiliza la opción writeConcern para especificar un nivel de confirmación de escritura (write concern) diferente. Si false, el balanceador no espera la replicación en un secundario y continúa con el siguiente documento. Para obtener más información, consulte Acelerador secundario.
writeConcern	Documento	opcional. Un documento que expresa el nivel de confirmación de escritura (write concern) que el _secondaryThrottle utilizará para esperar a los secundarios durante la migración de fragmentos. writeConcern requiere _secondaryThrottle: true.
_waitForDelete	booleano	opcional. Si se establece en true, la fase de borrar de una operación moveChunk es bloqueante. _waitForDelete es por defecto false. Cuando el campo _waitForDelete está configurado, MongoDB no espera el retraso orphanCleanupDelaySecs antes de realizar el borrado de rango. Si utiliza el parámetro _waitForDelete y hay operaciones de lectura en réplicas secundarias, es posible que la lectura omita documentos debido a la fase de borrado de la migración.

El valor de bounds toma la forma:

[ { hashedField : <minValue> } ,
  { hashedField : <maxValue> } ]

La sección Migración de fragmentos describe cómo se mueven los fragmentos entre las particiones de MongoDB.

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

Utiliza solo el moveChunk en circunstancias especiales, como al preparar tu clúster compartido para una primera ingesta de datos o una operación masiva de importación. En la mayoría de los casos, permite que el balanceador cree y equilibre fragmentos en clústeres fragmentados. Consulta Crear rangos en un clúster particionado para obtener más información.

Comportamiento

errmsg: "The collection's metadata lock is already taken."