sh.unshardCollection (método mongosh)

Definição

sh.unshardCollection( namespace, shardID )

Desfragmenta uma collection fragmentada existente e move os dados da collection para um único shard. Quando você desfragmenta uma collection, a collection não pode ser particionada em váriosshards e a chave de shard é removida.

Novidades na versão 8.0.

Importante

Método mongosh

Esta página documenta um método mongosh. Esta não é a documentação de comandos de banco de dados nem drivers específicos de linguagem, como Node.js.

Para o comando do banco de dados, consulte o comando unshardCollection.

Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.

O método sh.unshardCollection exige que você especifique o shard para receber os dados da collection. Com o comando unshardCollection , se você não especificar o shard de destino, o cluster selecionará automaticamente o shard com menos dados.

Se a coleção usar fragmentação de zona , você deverá primeiro remover as associações de intervalo e o fragmento da zona antes de desfragmentar a coleção. Para obter mais informações, consulte Não fragmentar zonas.

Observação

A desfragmentação de uma collection é uma operação de gravação intensiva que pode resultar em uma taxa de crescimento de oplog maior. Para ajudar a mitigar isso, considere as seguintes alterações de configuração:

• Para evitar o crescimento ilimitado do oplog, defina um tamanho fixo de oplog.

• Para reduzir a chance de os secundários se tornarem obsoletos, aumente o tamanho do oplog.

Para obter mais detalhes, consulte o oplog Conjunto de réplicas.

Sintaxe

sh.unshardCollection tem a seguinte sintaxe:

sh.unshardCollection( namespace, shardID )

Compatibilidade

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

• 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

• MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

Considerações

• sh.unshardCollection() só pode ser executado em clusters fragmentados.

• sh.unshardCollection() só pode operar em collections fragmentadas.

• sh.unshardCollection() só pode operar em uma única collection por vez.

• sh.unshardCollection() tem uma duração mínima de 5 minutos.

• Você deve reconstruir os índices do Atlas Search após a execução do sh.unshardCollection() .

• Você não pode fazer alterações na topologia , como adicionar ou remover fragmentos ou fazer a transição entre servidores de configuração incorporados e dedicados, até que sh.unshardCollection() seja concluído.

• Não é possível executar as seguintes operações na collection que está sendo desfragmentada enquanto sh.unshardCollection() estiver em andamento:

  • collMod

  • convertToCapped

  • createIndexes

  • db.collection.createIndexes()

  • drop

  • db.collection.drop()

  • dropIndexes

  • db.collection.dropIndex()

  • renameCollection

  • db.collection.renameCollection()

• Você não pode executar as seguintes operações no cluster enquanto o unshardCollection estiver em andamento:

  • addShard

  • removeShard

  • db.createCollection()

  • dropDatabase

  • transitionToDedicatedConfigServer

  • transitionFromDedicatedConfigServer

• As compilações de índice que ocorrem enquanto sh.unshardCollection() está em andamento podem falhar silenciosamente.

  • Não crie índices enquanto sh.unshardCollection() estiver em andamento.

  • Não chame sh.unshardCollection() se houver construções de índice em andamento.

Requisitos

Antes de desfragmentar sua collection, certifique-se de atender aos seguintes requisitos:

• Seu aplicação pode tolerar um período de dois segundos em que a collection afetada bloqueia as gravações. Durante o período em que as gravações são bloqueadas, seu aplicação experimenta um aumento na latência.

• Seu banco de dados atende aos seguintes requisitos de recursos:

  • Verifique se o fragmento para o qual você está movendo a collection tem espaço de armazenamento suficiente para a collection e seus índices. O fragmento de destino exige pelo menos ( Collection storage size + Index Size ) * 2 bytes disponíveis.

  • Certifique-se de que sua capacidade de E/S esteja abaixo de 50%.

  • Certifique-se de que a carga da CPU esteja abaixo de 80%.

Comportamento

Exemplos

sh.unshardCollection( "app.inventory", "shard02" )

sh.stopBalancer()

sh.status()

sh.removeRangeFromZone( {
   "app.inventory",
   { size: 100 },
   { size: 500 }
} )

sh.removeShardFromZone( "shard01", "mid" )

sh.startBalancer()

sh.unshardCollection( "app.inventory", "shard01" )

Saiba mais

• unshardCollection

• Desfragmentar uma collection