sh.moveChunk() (método mongosh)

Definición

sh.moveChunk(namespace, query, destination)

Mueve el fragmento que contiene el documento especificado por el query a la partición destination. sh.moveChunk() proporciona un contenedor alrededor del comando de base de datos moveChunk.

Importante

En la mayoría de las circunstancias, deja que el balanceador migre automáticamente los fragmentos, y evita llamar a sh.moveChunk() directamente.

Advertencia

Este comando no se puede usar para clave de partición con hash, ya que usa la opción find del comando moveChunk. Para mover un fragmento con una clave de partición con hash, utiliza el comando moveChunk especificando el campo bounds.

Importante

Método mongosh

Esta página documenta un método mongosh. Esta no es la documentación para los comandos de base de datos ni para los drivers específicos de lenguajes, como Nodo.js.

Para el comando de base de datos, consulta el comando moveChunk.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

sh.moveChunk() toma los siguientes argumentos:

Parameter	Tipo	Descripción
namespace	string	El namespace de la colección particionada que contiene el fragmento a migrar.
query	Documento	Una coincidencia exacta en la clave de partición que selecciona el fragmento a mover.
destination	string	El ID de la partición de destino.

Nota

Utiliza el comando listShards para recuperar el ID de la partición de destino.

Por defecto, MongoDB no puede mover un fragmento si la cantidad de documentos en el fragmento es mayor que 2 veces el resultado de dividir el tamaño del fragmento configurado por el tamaño promedio de los documentos. El comando moveChunk puede especificar la opción forceJumbo para permitir la migración manual de fragmentos demasiado grandes para mover, con o sin la etiqueta jumbo. Consulta el comando moveChunk para más detalles.

Compatibilidad

Este método 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.

Ejemplo

Dada la colección people en la base de datos records, la siguiente operación encuentra el fragmento que contiene los documentos con el campo zipcode establecido en 53187 y luego mueve ese fragmento a la partición llamada shard0019:

sh.moveChunk("records.people", { zipcode: "53187" }, "shard0019")