Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

Converter cluster fragmentado autogerenciado em conjunto de réplicas

Nesta página

  • Antes de começar
  • Converter um cluster com um único fragmento em um conjunto de réplicas
  • Converter um cluster fragmentado em um conjunto de réplicas
  • Próximos passos
  • Saiba mais

Este tutorial descreve como converter um cluster fragmentado em um conjunto de réplicas não fragmentadas. Para converter um conjunto de réplicas em um cluster fragmentado, consulte Converter um conjunto de réplicas autogerenciado em um cluster fragmentado. Consulte a documentação de fragmentação para obter mais informações sobre clusters fragmentados.

A partir do MongoDB 8.0, você pode usar a função directShardOperations para executar operações de manutenção que exigem a execução de comandos diretamente em um fragmento.

Aviso

Executar comandos utilizando a função directShardOperations pode fazer com que seu cluster pare de funcionar corretamente e pode causar corrupção de dados. Use a função directShardOperations apenas para fins de manutenção ou sob a orientação do suporte do MongoDB . Quando terminar de executar as operações de manutenção, pare de usar a função directShardOperations .

As etapas deste tutorial exigem o MongoDB 6.0 ou posterior.

Os comandosfsyncefsyncUnlockexigem a ação de autorizaçãofsync , que pode ser atribuída por meio da funçãohostManagerou de uma função personalizada.

Converta o cluster quando migrações de chunk, refragmentação e transformações de esquema não forem normalmente realizadas.

Para desabilitar o balanceador e bloqueio o cluster:

  1. Conecte mongosh o a uma mongos instância do no cluster fragmentado.

  2. Para parar o balanceador, execute:

    sh.stopBalancer()
  3. Para verificar se o balanceador está desativado, execute o seguinte comando e verifique se a saída é false:

    sh.getBalancerState()
  4. Para bloqueio o cluster fragmentado, que impede gravações do banco de dados , execute:

    db.getSiblingDB( "admin" ).fsyncLock()
  5. Para confirmar a bloqueio, execute:

    db.getSiblingDB( "admin" ).aggregate( [
    { $currentOp: { } },
    { $facet: {
    "locked": [
    { $match: { $and: [
    { fsyncLock: { $exists: true } }
    ] } }
    ],
    "unlocked": [
    { $match: { fsyncLock: { $exists: false } } }
    ]
    } },
    { $project: {
    "fsyncLocked": { $gt: [ { $size: "$locked" }, 0 ] },
    "fsyncUnlocked": { $gt: [ { $size: "$unlocked" }, 0 ] }
    } }
    ] )
  6. Certifique-se de que a saída mostre que fsyncLocked é true, o que significa que o cluster está bloqueado:

    [ { fsyncLocked: true }, { fsyncUnlocked: false } ]

No caso de um cluster fragmentado com apenas um fragmento, esse fragmento contém o conjunto de dados completo. Use o procedimento a seguir para converter esse cluster em um conjunto de réplicas não fragmentadas:

  1. Reconfigure o aplicativo para se conectar ao nó principal do conjunto de réplicas que hospeda o único fragmento em que o sistema será o novo conjunto de réplicas.

  2. Remova a opção --shardsvr do seu mongod.

    Dica

    A alteração da opção --shardsvr alterará a porta em que o mongod escuta conexões de entrada.

O cluster de fragmento único agora é um conjunto de réplicas não fragmentadas que aceitará operações de leitura e gravação no conjunto de dados.

Use o procedimento a seguir para fazer a transição de um cluster fragmentado com mais de um fragmento para um conjunto de réplicas totalmente novo.

  1. Com o cluster fragmentado bloqueado e o balanceador desabilitado, implemente um novo conjunto de réplicas além do seu cluster fragmentado. O conjunto de réplicas deve ter capacidade suficiente para manter todos os arquivos de dados de todos os shards atuais combinados. Não configure o aplicação para se conectar ao novo conjunto de réplicas até que a transferência de dados seja concluída.

  2. Reconfigure seu aplicação ou interrompa todas as instânciasmongos . Se você interromper todas as instâncias domongos, os aplicativos não poderão ler a partir do banco de dados. Se você interromper todas as instâncias domongos, inicie uma instância domongostemporária que os aplicativos não podem acessar para o procedimento de migração de dados.

  3. Use o mongodump e o mongorestore para migrar os dados da instância mongos para o novo conjunto de réplicas.

    Exclua o config banco de dados ao mongorestore executar. Use a opção como mostrado neste --nsExclude exemplo:

    mongorestore --nsExclude="config.*" <connection-string> /data/backup

    Observação

    Nem todas as coleções em todos os bancos de dados são necessariamente fragmentadas. Não migre apenas a coleção fragmentada. Certifique-se de que todos os bancos de dados e todas as coleções sejam migrados corretamente.

  4. Reconfigure o aplicativo para utilizar o conjunto de réplicas não fragmentadas em vez da instância mongos.

    Depois de converter o cluster fragmentado em um conjunto de réplicas, atualize a string de conexão usada pelos seus aplicativos para a string de conexão do conjunto de réplicas. Em seguida, reinicie seus aplicativos.

O aplicativo agora usará o conjunto de réplicas não fragmentadas para leituras e gravações. Agora você pode desativar a infraestrutura de cluster fragmentada não utilizada.

Depois de converter o cluster fragmentado em um conjunto de réplicas, execute as seguintes etapas para desbloquear o cluster:

  1. Para desbloquear o cluster e permitir que as gravações do banco de dados sejam retomadas, execute:

    db.getSiblingDB( "admin" ).fsyncLock()
  2. Para confirmar o desbloqueio, execute:

    db.getSiblingDB("admin").aggregate( [
    { $currentOp: { } },
    { $facet: {
    "locked": [
    { $match: { $and: [
    { fsyncLock: { $exists: true } }
    ] } } ],
    "unlocked": [
    { $match: { fsyncLock: { $exists: false } } }
    ]
    } },
    { $project: {
    "fsyncLocked": { $gt: [ { $size: "$locked" }, 0 ] },
    "fsyncUnlocked": { $gt: [ { $size: "$unlocked" }, 0 ] }
    } }
    ] )
  3. Certifique-se de que a saída mostre que fsyncLocked é false, o que significa que o cluster está desbloqueado:

    [ { fsyncLocked: false }, { fsyncUnlocked: true } ]

Gerenciar balancer de cluster fragmentado

Voltar

Fazer backup dos metadados do cluster