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. Conecte a qualquer mongos no cluster utilizando o shell do mongosh.

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.

A partir do MongoDB 6.0.3, a divisão automática de partes não é executada. Isso se deve a melhorias na política de balanceamento. Os comandos de divisão automática ainda existem, mas não executam uma operação.

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

Se você tiver definido a janela de balanceamento e quiser remover a programação para que o balanceador esteja sempre em execução, use $unset para limpar o activeWindow, como no exemplo a seguir:

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. Conecte a qualquer mongos no cluster utilizando o shell mongosh.

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.

   A partir do MongoDB 6.0.3, a divisão automática de partes não é executada. Isso se deve a melhorias na política de balanceamento. Os comandos de divisão automática ainda existem, mas não executam uma operação.

   Nas versões do MongoDB anteriores à 6.0.3, sh.stopBalancer() também desativa a divisão automática do cluster fragmentado.

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

   sh.getBalancerState()

   Opcionalmente, para verificar se nenhuma migração está em andamento após a desabilitação, execute a seguinte operação no shell mongosh:

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

db.adminCommand( { balancerStop: 1 } )

Habilite o balanceador

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

1. Conecte a qualquer mongos no cluster utilizando o shell mongosh.

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

   No shell do mongosh, comande:

   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 6.0.3, a divisão automática de partes não é executada. Isso se deve a melhorias na política de balanceamento. Os comandos de divisão automática ainda existem, mas não executam uma operação.

   Nas versões MongoDB anteriores a 6.0.3, o sh.startBalancer() também habilita a divisão automática 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:

• Defina a janela de balanceamento para que o balanceador fique inativo durante o backup. Certifique-se de que o backup possa ser concluído enquanto você desativa o balanceador.

• 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.

Para desabilitar o balanceamento em uma coleção, conecte-se a um mongos com o shell mongosh e chame o método sh.disableBalancing().

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.

Para ativar o balanceamento em uma coleção, conecte-se a um mongos com o shell mongosh e chame o método sh.enableBalancing().

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 }
)

Altere o tamanho máximo do armazenamento der um determinado shard

Para as versões 6.1 e anteriores do MongoDB, você ainda pode configurar um tamanho de armazenamento máximo para um determinado shard no cluster fragmentado utilizando o campo maxSize. Você pode encontrar dados de configuração relacionados a shards na collection config.shards .

Iniciando na versão 6.2, o MongoDB remove o campo maxSize do comando addShard. Como resultado:

• Executar addShard com o campo maxSize retorna um erro InvalidOptions.

• Novos documentos na collection shards não incluem mais o campo maxSize.

• Quaisquer entradas de campo maxSize pré-existentes são ignoradas.