/ /

Métodos de mongosh

Fragmentação

sh.moveRange()

Nesta página

Definição
Compatibilidade
Sintaxe
Exemplo

Definição

sh.moveRange(namespace, toShard, min, max): Novidades na versão 6.0.
Move intervalos entre shards.
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 moveRange.
Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.

Compatibilidade

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

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

Observação

Este comando é aceito em todos os clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, consulte Comandos não suportados.

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

Sintaxe

sh.moveRange(namespace, toShard, min, max)

O método sh.moveRange() utiliza os seguintes parâmetros:

Parâmetro	Tipo	Descrição
`namespace`	string	Define o banco de dados e a coleção do intervalo para mover.
`toShard`	string	Define o ID do fragmento para receber a faixa.
`min`	documento	Chave mínima do intervalo a ser movido.
`max`	documento	Chave máxima do intervalo a ser movido.

Exemplo

O exemplo a seguir usa uma coleção com:

Chave de fragmento postal, representando um código postal.
Uma faixa com os limites 70007 e 70124.

Para mover o intervalo postal para shard02, execute o seguinte método:

sh.moveRange(
   "contacts.addresses", "shard02",
   { postal: 70007 },
   { postal: 70124 }
)

{
  ok: 1,
  '$clusterTime': {
    clusterTime: Timestamp({ t: 1742507819, i: 42 }),
    signature: {
      hash: Binary.createFromBase64('AAAAAAAAAAAAAAAAAAAAAAAAAAA=', 0),
      keyId: Long('0')
    }
  },
  operationTime: Timestamp({ t: 1742507819, i: 42 })
}

Voltar

sh.moveCollection

sh.removeRangeFromZone