sh.reshardCollection() (método mongosh)

Definición

sh.reshardCollection(namespace, key, unique, options)

La sh.reshardCollection() El método cambia la clave de partición de una colección y cambia la distribución de tus datos.

Antes de reestructurar una colección, lee requisitos de redistribución y limitaciones de redistribución.

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 reshardCollection.

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

sh.reshardCollection() requiere los siguientes campos:

Campo	Tipo	Descripción
namespace	string	El namespace de la colección para particionar en la forma "<database>.<collection>".
key	Documento	El documento que especifica el nuevo campo o los nuevos campos a utilizar como clave de partición. { <field1>: <1|"hashed">, ... } Establezca los valores del campo en: 1 para particionado basado en rango "hashed" para especificar una clave de fragmento con hash. Véase también Índices de claves de fragmentos
unique	booleano	opcional. Especifica si existe una restricción de unicidad en la clave de partición. Sólo se admite false. Por defecto en false.
options	Documento	Opcional. Un documento que contiene campos opcionales, incluidos numInitialChunks, numSamplesPerChunk, collation, zones y forceRedistribution.

El campo options admite los siguientes campos:

Campo	Tipo	Descripción
numInitialChunks	entero	Opcional. Especifica el número inicial de fragmentos a crear en todas las particiones del clúster al reshardeando una colección. El valor por defecto es 90. Luego MongoDB crea y equilibra los fragmentos a lo largo del clúster. El numInitialChunks debe resultar en menos de 8192 por partición. Si ves el error “La clave de partición proporcionada no tiene suficiente cardinalidad para generar la cantidad requerida de fragmentos”, vuelva a hacer el sharding en la colección con un valor de numInitialChunks menor. A partir de MongoDB 8.2, las operaciones de redistribución ignoran la configuración numInitialChunks cuando la clave de partición contiene un prefijo encriptada. En cambio, MongoDB divide deterministicamente el espacio de claves encriptadas entre los recipientes, utilizando el mismo enfoque que para la creación inicial de los fragmentos en las colecciones encriptadas vacías.
numSamplesPerChunk	entero	Opcional. Especifica el número de documentos que se muestrearán en los nuevos fragmentos. Por defecto, MongoDB muestrea 10 documentos en cada fragmento. Nuevo en la versión 8.0.20.
collation	Documento	opcional. Si la colección especificada en reshardCollection tiene una intercalación por defecto,debe incluir un documento de intercalación { locale : "simple" } con, o el reshardCollection comando fallará.
zones	arreglo	Opcional. Especifica las zonas para la colección. Para mantener o agregar zonas, especifica las zonas para tu colección en un array: [ {s min: <document with same shape as shardkey>, max: <document with same shape as shardkey>, zone: <string> | null }, ... ]
forceRedistribution	booleano	opcional. Si se establece en true, la operación se ejecuta incluso si la nueva clave de partición es igual a la antigua clave de partición. Usar con la opción zones para mover datos a zonas específicas. Nuevo en la versión 8.0.

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.

Considerations

Las creaciones de índices que ocurren durante el rehashing podrían fallar silenciosamente.

• No cree índices durante el proceso de reorganización.

• No inicie el proceso de re-segmentación si hay compilaciones de índices en curso.

Si la colección que estás redistribuyendo usa MongoDB Search, el índice de búsqueda se vuelve inaccesible cuando la operación de redistribución finaliza. Debes reconstruir manualmente el índice de búsqueda una vez completada la operación de redistribución.

Proceso de re-partición

En una operación de refragmentación de una colección, un fragmento puede ser:

• dador, que actualmente almacena los fragmentos para la colección particionada.

• destinatario, que almacena nuevos fragmentos para la colección particionada en función de las claves de partición y zonas.

Una partición puede ser donante y receptor al mismo tiempo.

El servidor de configuración principal siempre es el coordinador de re-sharding e inicia cada fase de la operación de re-sharding.

Ejemplos

sh.reshardCollection( "sales.orders", { order_id: 1 } )

{
  ok: 1,
  '$clusterTime': {
    clusterTime: Timestamp(1, 1624887954),
    signature: {
      hash: Binary(Buffer.from("0000000000000000000000000000000000000000", "hex"), 0),
      keyId: 0
    }
  },
  operationTime: Timestamp(1, 1624887947)
}

sh.reshardCollection(
  "sales.orders",
  { order_id: 1 },
  { forceRedistribution: true }
)

{
  ok: 1,
  '$clusterTime': {
    clusterTime: Timestamp({ t: 1733502241, i: 20 }),
    signature: {
      hash: Binary.createFromBase64('AAAAAAAAAAAAAAAAAAAAAAAAAAA=', 0),
      keyId: Long('0')
    }
  },
  operationTime: Timestamp({ t: 1733502241, i: 20 })
}

sh.addShardToZone( "shard2", "NewZone" )
sh.addShardToZone( "shard3", "NewZone" )

sh.reshardCollection(
  "test.scores",
  { "studentId": 1, "testId": 1},
  { zones: [ {
    min: { "studentId": MinKey(), "testId": MinKey() },
    max: { "studentId": MaxKey(), "testId": MaxKey() },
    zone: "NewZone" }
    ]
} )

{
   ok: 1,
   '$clusterTime': {
   clusterTime: Timestamp( { t: 1699484530, i: 54 } ),
   signature: {
   hash: Binary.createFromBase64( "90ApBDrSSi4XnCpV3OWIH4OGO0Y=", 0 ),
   keyId: Long( "7296989036055363606" )
   } },
   operationTime: Timestamp( { t: 1699484530, i: 54 } )
}

Obtén más información

• Reshard a Collection