Definição
sh.startBalancer(timeout, interval)Alterado na versão 7.0.
Inicia o balanceador em um cluster fragmentado.
A partir do MongoDB 7.0, iniciar o balanceador também habilita a AutoMerger para o cluster fragmentado.
Importante
Método mongosh
Esta página documenta um método
mongosh. Esta não é a documentação para comandos de banco de dados ou drivers específicos de idioma, como Node.js.Para o comando do banco de dados, consulte o comando
balancerStart.Para drivers de API do MongoDB , consulte a documentação do driver MongoDB específica do idioma.
O método pode usar as seguintes opções:
ParâmetroTipoDescriçãotimeoutinteiro
Opcional. Limite de tempo para habilitar o balanceador.
O padrão é 60.000 milissegundos.
intervalinteiro
Opcional. A frequência (em milissegundos) com a qual verificar se uma rodada de balanceamento começou.
Você só pode executar
sh.startBalancer()em uma instânciamongos.sh.startBalancer()erros se executados na instânciamongod.
Compatibilidade
Esse método está disponível em implantações hospedadas nos seguintes ambientes:
- MongoDB Atlas: o serviço totalmente gerenciado para implantações MongoDB na nuvem
Importante
Este comando não é suportado em clusters M0 e Flex. Para obter mais informações, consulte Comandos não suportados.
MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB
Comportamento
O método shell mongosh sh.startBalancer() é um wrapper em torno do comando balancerStart. sh.startBalancer() executa o comando balancerStart em segundo plano e retorna imediatamente.
Saiba mais
Para saber como configurar o balanceador para seu cluster, consulte Gerenciar balanceador de cluster.
Para desabilitar o balanceamento para uma coleção específica, consulte Desabilitar balanceamento em uma coleção.
Para reativar o balanceamento em uma coleção específica, consulte Habilitar balanceamento em uma coleção.