balancerStop (comando de base de datos)

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

Definición

balancerStop

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.

Solo puedes emitir el balancerStop contra la base de datos admin en un mongos instancia.

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.

A partir de MongoDB 6.0.3, la división automática de fragmentos no se realiza. Esto se debe a mejoras en la política de balanceo. Los comandos de división automática aún existen, pero no realizan ninguna operación. Para más información, consulte Cambios en la política de balanceo.

En versiones de MongoDB anteriores a la 6.0, el comando desactiva la división automática para el clúster particionado. Para habilitar la división automática cuando el balanceador esté desactivado, puedes usar 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

El comando tiene la siguiente sintaxis:

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

Campos de comandos

Campo	Tipo	Descripción
`balancerStop`	any	Cualquier valor.
`maxTimeMS`	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 } )

Obtén más información

Volver

estado del balanceador

clearJumboFlag