Gerenciar balancer de cluster fragmentado

Verifique o estado do balancer

sh.getBalancerState() verifica se o balancer está habilitado (ou seja, se o balancer tem permissão para ser executado). sh.getBalancerState() não verifica se o balancer está migrando dados ativamente.

Para ver se o balanceador está habilitado no seu cluster fragmentado, execute o seguinte comando, que retorna um booleano:

sh.getBalancerState()

Você também pode ver se o balanceador está habilitado usando sh.status(). O campo currently-enabled indica se o balanceador está habilitado, e o campo currently-running indica se o balanceador está atualmente em execução.

Verifique se o balanceador está em execução

Para ver se o processo do balanceador está ativo em seu agrupamento:

1. Connect to any mongos in the cluster using the mongosh shell.

2. Utilize a seguinte operação para determinar se o balanceador está executando:

   sh.isBalancerRunning()

Configurar tamanho do intervalo padrão

O tamanho do intervalo padrão de um cluster fragmentado é de 128 megabytes. Na maioria das situações, o tamanho padrão é apropriado para dividir e migrar blocos. Para informações sobre como o tamanho do intervalo afeta as implantações, consulte detalhes, consulte Tamanho do intervalo.

A alteração do tamanho do intervalo padrão afeta os intervalos que forem processos durante as migrações e as divisões automáticas, mas não afeta todos os intervalos de forma retroativa.

Para configurar o tamanho padrão da faixa, consulte Modificar o tamanho da faixa em um cluster fragmentado.

Agendamento da janela de balanceamento

Em algumas situações, especialmente quando o conjunto de dados cresce lentamente e uma migração pode afetar o desempenho, é útil garantir que o balanceador esteja ativo apenas em determinados momentos. O procedimento a seguir especifica o activeWindow, que é o período durante o qual o balanceador poderá migrar os blocos:

use config

sh.startBalancer()

db.settings.updateOne(
   { _id: "balancer" },
   { $set: { activeWindow : { start : "<start-time>", stop : "<stop-time>" } } },
   { upsert: true }
)

Remoção de um agendamento de janela de balanceamento

If you have set the balancing window and wish to remove the schedule so that the balancer is always running, use $unset to clear the activeWindow, as in the following:

use config
db.settings.updateOne( { _id : "balancer" }, { $unset : { activeWindow : true } } )

Desabilitar o balancer

Por padrão, o balanceador pode executar a qualquer momento e mover apenas os blocos conforme necessário. Para desabilitar o balanceador por um curto período de tempo e evitar toda a migração, use o seguinte procedimento:

1. Connect to any mongos in the cluster using the mongosh shell.

2. Comande a seguinte operação para desativar o balanceador:

   sh.stopBalancer()

   Se houver uma migração em andamento, o sistema concluirá a migração em andamento antes de encerrar.

3. Para verificar se o balanceador não iniciará, execute o seguinte comando, que retornará false se o balanceador estiver desabilitado:

   sh.getBalancerState()

   Optionally, to verify no migrations are in progress after disabling, run the following operation in the mongosh shell:

   use config
   while( sh.isBalancerRunning() ) {
             print("waiting...");
             sleep(1000);
   }

db.adminCommand( { balancerStop: 1 } )

A partir do MongoDB 7.0, interromper o balanceador também desativará o AutoMerger para o cluster fragmentado.

Habilite o balanceador

Use este procedimento se você tiver desabilitado o balancer e estiver pronto para reativá-lo:

1. Connect to any mongos in the cluster using the mongosh shell.

2. Comande uma das seguintes operações para habilitar o balanceador:

   From the mongosh shell, issue:

   sh.startBalancer()

   Observação

   Para habilitar o balanceador a partir de um driver, use o comando BalancerStart no admin banco de dados , como mostrado a seguir:

   db.adminCommand( { balancerStart: 1 } )

A partir do MongoDB 7.0, iniciar o balanceador também habilita a AutoMerger para o cluster fragmentado.

Desativação do balanceamento durante backups

Se o MongoDB migrar um bloco durante um backup, você poderá terminar com um instantâneo inconsistente do cluster fragmentado. Nunca execute um backup enquanto o balanceador estiver ativo. Para garantir que o balanceador esteja inativo durante a operação de backup:

• Set the balancing window so that the balancer is inactive during the backup. Ensure that the backup can complete while you have the balancer disabled.

• Desative manualmente o balanceador durante o procedimento de backup.

Se você desligar o balanceador enquanto ele estiver no meio de uma rodada de balanceamento, o desligamento não será instantâneo. O balanceador completa o movimento do bloco em andamento e, em seguida, interrompe todas as rodadas de balanceamento adicionais.

Antes de iniciar uma operação de cópia de segurança, confirme se o balanceador não está ativo. Você pode usar o seguinte comando para determinar se o balanceador está ativo:

!sh.getBalancerState() && !sh.isBalancerRunning()

Quando o procedimento de backup estiver concluído, você poderá reativar o processo do balanceador.

Desativação do balanceamento em uma collection

Você pode desabilitar o balanceamento para uma collection específica com o método sh.disableBalancing(). Talvez você queira desabilitar o balancer para uma collection específica para permitir operações de manutenção ou volumes de trabalho atípicos, por exemplo, durante ingestões de dados ou exportações de dados.

Se você desabilitar o balanceamento em uma coleção, o MongoDB não interromperá as migrações em andamento.

To disable balancing on a collection, connect to a mongos with the mongosh shell and call the sh.disableBalancing() method.

Por exemplo:

sh.disableBalancing("students.grades")

O método sh.disableBalancing() aceita como seu parâmetro o espaço de nomes completo da coleção.

Como habilitar o balanceamento em uma coleção

Você pode habilitar o equilíbrio para uma coleção específica com o método sh.enableBalancing().

Quando você habilita o equilíbrio para uma coleção, o MongoDB não imediatamente começará a equilibrar dados. No entanto, se os dados em sua coleção fragmentada não estiverem balanceados, o MongoDB poderá começar a distribuir os dados de maneira mais uniforme.

To enable balancing on a collection, connect to a mongos with the mongosh shell and call the sh.enableBalancing() method.

Por exemplo:

sh.enableBalancing("students.grades")

O método sh.enableBalancing() aceita como seu parâmetro o espaço de nomes completo da coleção.

Verifique se o equilíbrio está ativado ou desativado

Para confirmar se o balanceamento de uma coleção está ativado ou desativado, consulte a coleção collections no banco de dados config para obter o namespace da coleção e verifique o campo noBalance. Por exemplo:

db.getSiblingDB("config").collections.findOne({_id : "students.grades"}).noBalance;

Essa operação retornará um erro de valor null, true, false ou nenhuma saída:

• Um erro de valor null indica que o namespace da collection está incorreto.

• Se o resultado for true, o balanceamento será desativado.

• Se o resultado for false, o equilíbrio está habilitado atualmente, mas foi desabilitado no passado para a coleção. O balanceamento dessa coleção começará na próxima vez que o balanceador for executado.

• Se a operação não retornar saída, o balanceamento será habilitado atualmente e nunca foi desabilitado no passado para esta coleção. O balanceamento dessa coleção começará na próxima vez que o balanceador for executado.

Você também pode ver se o balanceador está ativado usando sh.status(). O campo currently-enabled indica se o balanceador está habilitado.

Alteração do comportamento de replicação para migração de partes

use config
db.settings.updateOne(
   { "_id" : "balancer" },
   { $set : { "_secondaryThrottle" : { "w": "majority" }  } },
   { upsert : true }
)

db.getSiblingDB("config").settings.updateOne(
   { _id: "balancer" },
   { $set: { attemptToBalanceJumboChunks : true } },
   { upsert: true }
)