sh.moveChunk() (método mongosh)

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 6.0, consulta el Procedimientos de actualización de MongoDB 7.0 .

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 para el 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.

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 nombre de la partición a mover.

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.

Tip

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

Importante

Este comando no es compatible con los clústeres M0 y Flex. Para obtener más información, consulta Comandos no compatibles.

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")

Volver

sh.isBalancerRunning

sh.moveRange