dividir

Definição

split

Alterado na versão 4,2.

Divisão um parte em um cluster fragmentado em dois parte. A partir do MongoDB 4.2, os shards managed e divisão os parte com base nas estatísticas de tamanho do parte que mantêm.

Para circunstâncias excepcionais, o comando split permite que os administradores criem divisões manualmente. Consulte Dividir pedaços em um cluster fragmentado para obter informações sobre essas circunstâncias e sobre os comandos de shell do MongoDB que envolvem split.

Dica

Em mongosh, esse comando também pode ser executado por meio dos métodos sh.splitAt() e sh.splitFind() auxiliar.

Os métodos auxiliares são convenientes para os usuários mongosh , mas podem não retornar o mesmo nível de informações que os comandos do banco de dados. Nos casos em que a conveniência não for necessária ou os campos de retorno adicionais forem necessários, use o comando de banco de dados.

O comando split deve ser executado no banco de dados admin e utiliza o seguinte formulário:

db.adminCommand( { split: <database>.<collection>,
                   <find|middle|bounds> } )

O comando split recebe um documento com os seguintes campos:

Campo	Tipo	Descrição
split	string	O nome da collection onde o chunk existe. Especifique o namespace completo da coleção, incluindo o nome do banco de dados.
find	documento	Uma query que especifica uma correspondência de igualdade na chave de fragmento. A correspondência seleciona a parte que contém o documento especificado. Você deve especificar somente uma das seguintes opções: find, bounds ou middle. Você não pode usar a opção find em uma collection vazia.
bounds	variedade	Novidades na versão 2.4: Os limites de uma parte para divisão. bounds se aplica a partes em collection particionadas usando uma chave de fragmento com hash. A array do parâmetro deve consistir em dois documento especificando os valores de chave de fragmento inferior e superior da parte. Os valores devem corresponder aos valores mínimo e máximo de uma parte existente. Especifique apenas uma das seguintes opções: find, bounds ou middle. Você não pode usar a opção bounds em uma collection vazia.
middle	documento	O documento a ser usado como ponto de divisão para criar dois chunks. split requer uma das seguintes opções: find, bounds ou middle.

Considerações

Quando usado com a opção find ou bounds , o comando split divide o chunk ao longo da mediana. Dessa forma, o comando não pode usar a opção find ou bounds para dividir um chunk vazio, pois um chunk vazio não tem mediana.

Para criar divisões em blocos vazios, use a opção middle com o comando split ou use o comando sh.splitAt() .

Formatos de comando

Para criar uma divisão de parte, conecte-se a uma instância mongos e emita o seguinte comando para o reconhecimento de data center admin :

db.adminCommand( { split: <database>.<collection>,
                   find: <document> } )

Ou:

db.adminCommand( { split: <database>.<collection>,
                   middle: <document> } )

Ou:

db.adminCommand( { split: <database>.<collection>,
                   bounds: [ <lower>, <upper> ] } )

Para criar uma divisão para uma collection que utiliza uma chave de fragmento com hash, utilize o parâmetro bounds. Não utilize o parâmetro middle para este propósito.

Exemplos

As seções seguintes fornecem exemplos do comando split .

db.adminCommand( { split : "test.people", find : { _id : 99 } } )

db.adminCommand( { split : "test.people", middle : { _id : 99 } } )

db.adminCommand( { split: "test.people",
                  bounds : [ { userid: NumberLong("-5838464104018346494") },
                             { userid: NumberLong("-5557153028469814163") }
             ] } )

Erro de bloqueio de metadados

Se outro processo, como um processo de balancer, alterar metadados enquanto split estiver em execução, você poderá ver um metadata lock error.

errmsg: "The collection's metadata lock is already taken."

Esta mensagem indica que a divisão falhou sem efeitos colaterais. Tente novamente o comando split .