balancerStatus (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

balancerStatus

Devuelve un documento que contiene información sobre el estado del balanceador.

Sólo puedes emitir el balancerStatus contra la base de datos admin.

Tip

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

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.

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(
   {
     balancerStatus: 1
   }
)

Documento de salida

El siguiente es un ejemplo de un documento devuelto por el comando:

{
   "mode" : "full",
   "inBalancerRound" : false,
   "numBalancerRounds" : Long(86),
   "ok" : 1
}

Campo	Descripción
`"mode"`	Una string que especifica si el hilo del balanceador está en ejecución o detenido. Los valores posibles son: "completo" El hilo del Balanceador está en ejecución, pero no necesariamente en una ronda de balanceo. "apagado" El hilo del balanceador está detenido. No se puede producir un equilibrio de fragmentos en este modo.
`"inBalancerRound"`	Un valor booleano que indica si el equilibrador está en una ronda de equilibrio. Si `inBalancerRound=true`, ahora está distribuyendo fragmentos. `inBalancerRound` Puede ser `true` cuando `mode=off`. Si desactivas el balanceador durante una ronda de balanceo, el servidor lo deja terminar en lugar de interrumpirlo.
`"numBalancerRounds"`	La cantidad de rondas de balanceador que han ocurrido desde que se iniciaron los servidores de configuración. Este valor no se persiste y se restablece a 0 al reiniciar los servidores de configuración.

Ejemplo

Conéctese a una instancia de mongos y emita el siguiente comando:

db.adminCommand( { balancerStatus: 1 } )

Volver

balanceadorInicio

equilibradorStop