sh.moveChunk()

Definição

sh.moveChunk(namespace, query, destination)

Move ochunk que contém o documento especificado pelo query para o shard destination . sh.moveChunk() fornece um wrapper em torno do comando de banco de dados moveChunk banco de dados.

Importante

Na maioria das circunstâncias, permita que o balanceador migre automaticamente os blocos e evite chamar sh.moveChunk() diretamente.

Aviso

Esse comando não pode ser usado para chave de fragmento com hash, pois usa a opção find do comando moveChunk . Para mover uma parte com uma chave de fragmento com hash, use o comando moveChunk especificando o campo bounds .

Importante

Método mongosh

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

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

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

sh.moveChunk() recebe os seguintes argumentos:

Parâmetro	Tipo	Descrição
namespace	string	O namespace da collection fragmentada que contém a parte a ser migrado.
query	documento	Uma correspondência de igualdade na chave de fragmento que seleciona a parte a ser movida.
destination	string	O nome do fragmento a ser movido.

Por padrão, o MongoDB não poderá mover um chunk se o número de documentos no chunk for maior que 2 vezes o resultado da divisão do tamanho do chunk configurado pelo tamanho médio do documento . O comando moveChunk pode especificar a opção forceJumbo para permitir a migração manual de chunks grandes demais para serem movidos, com ou sem o rótulo jumbo . Consulte comando moveChunk para detalhes.

Compatibilidade

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

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

• 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

Exemplo

Dada a collection people no reconhecimento de data center records, a operação a seguir localiza a parte que contém o documento com o campo zipcode definido como 53187 e, em seguida, move essa parte para o fragmento chamado shard0019:

sh.moveChunk("records.people", { zipcode: "53187" }, "shard0019")