Definición
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
El comando tiene la siguiente sintaxis:
db.adminCommand( { configureCollectionBalancing: "<db>.<collection>", chunkSize: <num>, defragmentCollection: <bool>, enableAutoMerger: <bool>, enableBalancing: <bool> } )
Campos de comandos
configureCollectionBalancing tiene los siguientes campos:
Campo | Tipo | Necesidad | Descripción |
|---|---|---|---|
| string | Requerido | El nombre de la base de datos y de la colección particionada que se va a configurar. |
| entero | Opcional | Establece el tamaño de fragmento en MiB para la colección. El tamaño recomendado es 256, 512 o mayor. Para obtener detalles sobre el comportamiento por defecto, consulte Comportamiento por defecto cuando no se especifica chunkSize. |
| booleano | Opcional | Hace que el balanceador desfragmente la colección. Por defecto, es |
| booleano | Opcional | Establece si el AutoMerger toma en cuenta esta colección. Por defecto, |
| booleano | Opcional | Establece si el balanceador opera en la colección. Cuando se establece en Nuevo en la versión 8.1. |
Para obtener más información, consulta Particionamiento de datos con fragmentos.
Para configurar el parámetro de tiempo para la limitación por fragmentación de fragmento, consulta chunkDefragmentationThrottlingMS.
Para aprender sobre la desfragmentación de colecciones particionadas, consulte Desfragmentar Colecciones Particionadas.
Comportamiento
Comportamiento por defecto cuando no se especifica chunkSize
Si no se especifica chunkSize para una colección y no se ha establecido un tamaño personalizado previamente, se utiliza el valor global por defecto chunkSize para el balanceo.
Especificar chunkSize: 0
Si utilizas configureCollectionBalancing con chunkSize: 0, el chunkSize por colección se restablece y se utiliza la media global por defecto chunkSize para el equilibrio.
Para obtener más información sobre la configuración por defecto de chunkSize, consulte Modificar el tamaño del rango en un clúster
Comportamiento por defecto cuando enableAutoMerger no está especificado
Si no especificas enableAutoMerger para una colección y no se ha definido previamente ningún comportamiento personalizado de fusión automática, se establece por defecto en true y será tenido en cuenta por el AutoMerger.
Parameter Validation
A partir de 8.2, MongoDB valida la ortografía de los parámetros que pasa a configureCollectionBalancing. Si escribes mal un parámetro, configureCollectionBalancing no se ejecuta y devuelve un error.
Ejemplos
Configurar el tamaño de fragmento
Para cambiar el tamaño del fragmento de una colección particionada, use la opción chunkSize:
db.adminCommand( { configureCollectionBalancing: "test.students", chunkSize: 256 } )
Utilice este comando para cambiar el tamaño del fragmento de la colección dada.
Advertencia
De forma predeterminada, MongoDB no puede mover un fragmento si el número de documentos en el fragmento es mayor que 2 veces el resultado de dividir el tamaño de fragmento configurado por el tamaño promedio del documento.
Para encontrar el tamaño promedio del documento, consulte el campo avgObjSize en la salida del db.collection.stats() método.
Para obtener más información, consulta Tamaño del rango.
Desfragmentar colecciones
Advertencia
No recomendamos utilizar defragmentCollection para desfragmentar colecciones particionadas para MongoDB 6.0.0 a 6.0.3 y MongoDB 6.1.0 a 6.1.1, ya que el proceso de desfragmentación en estas versiones puede hacer que las bases de datos y colecciones no estén disponibles durante períodos prolongados de tiempo.
Para indicarle al equilibrador que desfragmente una colección particionada, debe usar la opción defragmentCollection:
db.adminCommand( { configureCollectionBalancing: "test.students", defragmentCollection: true } )
Utilice este comando para que el balanceador desfragmente una colección particionada. Para supervisar el proceso de desfragmentación de los fragmentos, utiliza el comando balancerCollectionStatus.
Para obtener más información sobre la desfragmentación de colecciones particionadas, consulta Desfragmentar colecciones particionadas.
Reconfiguración y desfragmentación de colecciones
Para desfragmentar una colección particionada mientras actualizas el tamaño del fragmento, utiliza la opción defragmentCollection y la opción chunkSize juntas:
db.adminCommand( { configureCollectionBalancing: "test.students", chunkSize: 512, defragmentCollection: true } )
Desactivar el AutoMerger en una Colección
Para desactivar explícitamente el AutoMerger en una colección, configure la opción enableAutoMerger en false:
db.adminCommand( { configureCollectionBalancing: "test.students", enableAutoMerger: false } )
Deshabilitar el balanceo en una colección
Para desactivar explícitamente el balanceador en una colección, ajusta la opción enableBalancing en false:
db.adminCommand( { configureCollectionBalancing: "test.students", enableBalancing: false } )