Definición
sh.moveRange(namespace, toShard, min, max)Nuevo en la versión 6.0.
Moves ranges between partición.
Importante
Método mongosh
This page documents a
mongoshmethod. This is not the documentation for database commands or language-specific drivers, such as Node.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
This command is supported in all MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.
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 que se va a mover. |
| string | Establece el ID de la partición que recibirá el rango. |
| Documento | Clave mínima del rango para mover. |
| Documento | Clave máxima del rango a mover. |
Ejemplo
El siguiente ejemplo emplea una colección con:
Clave de partición
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 }) }