equilibradorStop

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 5.0, consulta el Procedimientos de actualización de MongoDB.6.0

Definición

balancerStop

Novedad en la versión 3.4.

Desactiva el balanceador en un clúster. Si una ronda de balanceo está en curso, la operación espera a que se complete el balanceo.

A partir de MongoDB 4.2, el comando deshabilita la división automática en el clúster fragmentado. Para habilitar la división automática cuando el balanceador está deshabilitado, puede usar sh.enableAutoSplit().

Solo puede emitir el balancerStop contra la base de datos admin en una instancia mongos.

Importante

Dejar el balanceador deshabilitado durante largos periodos puede generar fragmentos desequilibrados, lo que reduce el rendimiento del clúster. Desactive el balanceador solo si es necesario y asegúrese de volver a habilitarlo al finalizar el mantenimiento.

Tip

En mongosh, este comando también se puede ejecutar a través del método asistente sh.stopBalancer().

Los métodos asistente son convenientes para usuarios de mongosh, pero es posible que no proporcionen el mismo nivel de información que los comandos de base de datos. En los casos en que no se necesite la conveniencia o se requieran campos de retorno adicionales, utiliza el comando de base de datos.

En versiones de MongoDB más antiguas que la 6.1, el comando deshabilita la división automática para el clúster particionado. Para habilitar la división automática cuando el balanceador está deshabilitado, puedes utilizar sh.enableAutoSplit().

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

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

Solo puede emitir el balancerStop contra la base de datos admin en una instancia mongos.

El comando toma la siguiente forma:

db.adminCommand( { balancerStop: 1, maxTimeMS: <number> } )

Campo	Tipo	Descripción
`balancerStop`	any	Cualquier valor.
`maxTimeMS`	entero	Límite de tiempo para desactivar el balanceador. Por defecto, 60 000 milisegundos. Cambiado en la versión 3.4: Si se utiliza la shell `mongo` 3.4 con versiones anteriores de clústeres fragmentados, el parámetro especifica la cantidad de milisegundos que se debe esperar para que la ronda de balanceo se detenga.

Ejemplo

Para detener el hilo del balanceador, conéctate a una instancia de mongos y ejecuta el siguiente comando:

db.adminCommand( { balancerStop: 1 } )

Obtén más información

Volver

estado del balanceador

clearJumboFlag