sh.unshardCollection (método mongosh)

Definição

sh.unshardCollection( namespace, shardID )

Desfaz a fragmentação de uma coleção fragmentada existente e move os dados da coleção para um único fragmento. Quando você desfragmenta uma coleção, a coleção não pode ser particionada em vários fragmentos, e a chave de fragmento é removida.

Novidades na versão 8.0.

Importante

Método mongosh

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as 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() .

• writeConcernMajorityJournalDefault deve ser true.

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

• Para evitar erros, o MongoDB descarta automaticamente as zonas da sua coleção quando você executa o unshardCollection.

• If the collection you're unsharding uses Atlas Search, the search index becomes unavailable when the unsharding operation completes. You need to manually rebuild the search index once the unsharding operation completes.

• If the collection you're unsharding is archived in Atlas Online Archives, the online archive files are marked as Orphaned once the unsharding operation completes. You can create another online archive for the same database, collection, and fields as the orphaned archive as long as there is no other archive for that same combination in the Active state.

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