Menu Docs

sh.moveRange()

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

Novidades na versão 6.0.

Moves ranges between 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.

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

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

The sh.moveRange() method takes the following parameters:

Parâmetro
Tipo
Descrição

namespace

string

Sets the database and collection of the range to move.

toShard

string

Sets the ID of the shard to receive the range.

min

documento

Minimum key of the range to move.

max

documento

Maximum key of the range to move.

The following example uses a collection with:

  • Shard key postal, representing a postal code.

  • A range with the boundaries 70007 and 70124.

To move the postal range to shard02, run the following method:

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 })
}