moveChunk

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. El valor de bounds toma la siguiente forma: [ { hashedField : <minValue> } , { hashedField : <maxValue> } ]
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 fragmentos grandes sin este largo período de bloqueo, consulta Equilibra fragmentos que Exceden el Límite de Tamaño en su lugar.
_secondaryThrottle	booleano	Opcional. Se establece por defecto en 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	Obligatorio si _secondaryThrottle es true. Un documento que contiene el nivel de confirmación de escritura (write concern) que _secondaryThrottle utiliza para esperar a los secundarios durante la migración de fragmentos. Si _secondaryThrottle es false, se ignora el campo writeConcern.
_waitForDelete	booleano	opcional. Opción interna para fines de prueba. Por defecto es false. Si se establece en true, la fase de borrar de una operación moveChunk se bloquea.

Para aprender cómo se mueven los fragmentos entre particiones, consulta Migración de fragmentos.

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

Solo use el moveChunk en circunstancias especiales como prepararse para un clúster para una primera carga de datos o una operación de importación masiva. En la mayoría de los casos, permitir que el balanceador cree y balancee fragmentos en clústeres. Consulte Crear fragmentos en un clúster para obtener más información.

Comportamiento

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