Definición
balancerStopDesactiva el balanceador en un clúster. Si una ronda de balanceo está en curso, la operación espera a que se complete el balanceo.
Solo puede emitir el comando contra
balancerStoplaadminbase de datos en unamongosinstancia.A partir de MongoDB 7.0, detener el balanceador también desactiva el AutoMerger para el clúster.
Importante
Dejar el balanceador deshabilitado durante períodos prolongados puede conducir a particiones desequilibradas, lo que degrada el rendimiento del clúster. Solo desactive el balanceador si es necesario y asegúrese de volver a habilitar el balanceador cuando el mantenimiento esté completo.
Tip
mongoshEn, este comando también se puede ejecutar a través del métodosh.stopBalancer()auxiliar.Los métodos auxiliares son convenientes para
mongoshlos usuarios de, pero es posible que no devuelvan el mismo nivel de información que los comandos de la base de datos. En los casos en que no se necesite la conveniencia o se requieran los campos de retorno adicionales, utilice el comando de la base de datos.
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
El comando tiene la siguiente sintaxis:
db.adminCommand( { balancerStop: 1, maxTimeMS: <number> } )
Campos de comandos
Campo | Tipo | Descripción |
|---|---|---|
| any | Cualquier valor. |
| entero | Límite de tiempo para desactivar el balanceador. Por defecto, 60 000 milisegundos. |
Ejemplo
Para detener el hilo del balanceador, conéctate a una instancia de mongos y ejecuta el siguiente comando:
db.adminCommand( { balancerStop: 1 } )