Definición
sh.moveRange(namespace, toShard, min, max)Novedades en la versión 6.0.
mueve rangos entre fragmentos.
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
moveRange.Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.
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
Nota
Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulte 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.
Sintaxis
sh.moveRange(namespace, toShard, min, max)
El método sh.moveRange() acepta los siguientes parámetros:
Parameter | Tipo | Descripción |
|---|---|---|
| string | Establece la base de datos y la colección del rango a mover. |
| string | Establece el ID del fragmento que recibirá el rango. |
| Documento | Tecla mínima del rango a mover. |
| Documento | Tecla máxima del rango a mover. |
Ejemplo
El siguiente ejemplo utiliza una colección con:
Clave de fragmento
postal, que representa un código postal.Un rango con los límites
70007y70124.
Para mover el rango postal a shard02, ejecute el siguiente método:
sh.moveRange( "contacts.addresses", "shard02", { postal: 70007 }, { postal: 70124 } )
{ ok: 1, '$clusterTime': { clusterTime: Timestamp({ t: 1742507819, i: 42 }), signature: { hash: Binary.createFromBase64('AAAAAAAAAAAAAAAAAAAAAAAAAAA=', 0), keyId: Long('0') } }, operationTime: Timestamp({ t: 1742507819, i: 42 }) }