moveRange (comando de base de datos)

Definición

moveRange: Nuevo en la versión 6.0.
Moves ranges between shards. Run the moveRange command with a mongos instance while using the admin database.
Tip
In mongosh, this command can also be run through the sh.moveRange() helper method.
Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

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

El comando tiene la siguiente sintaxis:

db.adminCommand(
  {
    moveRange: <namespace>,
    toShard: <ID of the recipient shard>,
    min: <min key of the range to move>, // conditional
    max: <max key of the range to move>, // conditional
    forceJumbo: <bool>, // optional
    writeConcern: <write concern>, // optional
    secondaryThrottle: <bool> // optional
  }
)

Campos de comandos

El comando toma los siguientes campos:

Campo	Tipo	Descripción
`toShard`	string	ID de la partición receptora.
`min`	llave	Clave mínima del rango a mover. Obligatorio si no especifica `max`. Si no especificas `min`, dado un fragmento `C` donde `max` sea el límite superior exclusivo de `C` o `C` incluya la clave de partición `max`, `min` se determina de la siguiente manera: Si el tamaño de los datos del rango entre `min(C)` y `max` es menor que el tamaño de fragmento por colección o el tamaño de fragmento por defecto, el valor `min` del fragmento se selecciona como `min` = `min(C)`. De lo contrario, clave `min` > `min(C)` donde `min` depende del tamaño de fragmento configurado.
`max`	llave	Clave máxima del rango a mover. Obligatorio si no se especifica `min`. Si no se especifica `max`, dado un fragmento `C` que incluye la clave de partición `min`, `max` se determina de la siguiente manera: Si el tamaño de datos del rango entre `min` y `max(C)` es menor que el tamaño de fragmento por colección o el tamaño de fragmento por defecto, el máximo del fragmento se selecciona como `max` = `max(C)`. Si no, clave `max` < `max(C)` donde `max` depende del tamaño de fragmento configurado.
forzarJumbo	booleano	Opcional. Indicador que determina si el comando puede mover un rango demasiado grande para migrar. El rango puede estar o no etiquetado como jumbo. Si `true`, el comando puede mover el rango. Si `false`, el comando no puede mover el rango. El valor es por defecto `false`. ADVERTENCIA: El comando `moveRange` 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 grandes fragmentos sin este largo período de bloqueo, consulta Balancear rangos que exceden el límite de tamaño en su lugar.
`writeConcern`	Documento	Opcional. Documento con el nivel de confirmación de escritura (write concern). El valor por defecto es `w: majority`.
`secondaryThrottle`	booleano	Opcional. Si `true`, cada movimiento de documentos durante la migración de fragmentos se propaga al menos a un secundario antes de que el balanceador proceda con el siguiente documento. Esto equivale 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.

La sección Migración de rango describe cómo se mueven los rangos entre particiones en MongoDB.

Considerations

Only use the moveRange in scenarios like:

una ingesta inicial de datos
una gran operación de importación masiva

Permitir al balanceador crear y equilibrar rangos en clústeres en la mayoría de los casos.

Tip

Crear rangos en un clúster fragmentado

Ejemplos

Los siguientes ejemplos usan una colección con:

clave de partición x
Tamaño de fragmento configurado de 128 MB
Un fragmento con delimitaciones: [x: 0, x: 100)

Especifica tanto `min` como `max`

La siguiente tabla enumera los resultados de configurar min y max con varios valores:

`min`	`max`	Resultado
`0`	`100`	Mueve todos los documentos del rango a la partición destinataria.
`10`	`30`	Crea tres subrangos: `[x: 0, x: 10)` `[x: 10, x: 30)` `[x: 30, x: 100)` Mueve todos los documentos de `[x: 10, x: 30)` a la partición receptora.
`0`	`20`	Crea dos subrangos: `[x: 0, x: 20)` `[x: 20, x: 100)` Mueve todos los documentos de `[x: 0, x: 20)` a la partición receptora.
`40`	`100`	Crea dos subrangos: `[x: 0, x: 40)` `[x: 40, x: 100)` Mueve todos los documentos de `[x: 40, x: 100)` a la partición receptora.

Especifica `min` pero no `max`

La siguiente tabla muestra los resultados de configurar min a varios valores:

`min`	Cantidad de datos en el rango clave	Resultado
`0`	Menos de 128 MB contenidos entre las claves `x: 0` y `x: 100`.	Mueve todos los documentos del rango a la partición destinataria.
`10`	Menos de 128 MB contenidos entre las claves `x: 0` y `x: 100`.	Crea dos subrangos: `[x: 0, x: 10)` `[x : 10, x: 100)` Mueve todos los documentos en `[x: 10, x: 100)` a la partición de destino.
`10`	128 MB contenidos entre las claves `x: 10` y `x: 30`.	Crea tres subrangos: `[x: 0, x: 10)` `[x: 10, x: 30)` `[x: 30, x: 100)` Mueve todos los documentos en `[x: 10, x: 30)` a la partición de destino.

Especifica `max` pero no `min`

La siguiente tabla muestra los resultados de configurar max a varios valores:

`max`	Cantidad de datos en el rango clave	Resultado
`100`	Menos de 128 MB contenidos entre las claves `x: 0` y `x: 100`.	Mueve todos los documentos del rango a la partición destinataria.
`10`	Menos de 128 MB contenidos entre las claves `x: 0` y `x: 100`.	Crea dos subrangos: `[x: 0, x: 10)` `[x : 10, x: 100)` Mueve todos los documentos en `[x: 0, x: 10)` a la partición de destino.
`30`	128 MB contenidos entre las claves `x: 10` y `x: 30`.	Crea tres subrangos: `[x: 0, x: 10)` `[x: 10, x: 30)` `[x: 30, x: 100)` Mueve todos los documentos en `[x: 10, x: 30)` a la partición de destino.

Volver

movePrimary

Combinar fragmentos