sh.reshardCollection()

Definição

sh.reshardCollection(namespace, key, unique, options)

Novidades na versão 5.0.

O método sh.reshardCollection() altera a chave de fragmento de uma coleção e altera a distribuição de seus dados.

Antes de refragmentar uma coleção, leia os requisitos de refragmentação e as limitações de refragmentação.

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

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

sh.reshardCollection() usa os seguintes campos:

Campo	Tipo	Descrição
namespace	string	O namespace da collection para fragmentar no formato "<database>.<collection>".
key	documento	O documento que especifica o novo campo ou campos a serem usados como a chave de shard. { <field1>: <1|"hashed">, ... } Defina os valores do campo como: 1 para fragmentação baseada em faixa "hashed" para especificar uma chave de fragmento com hash. Consulte também Índices de chaves de shard
unique	booleano	Opcional. Especifique se há uma restrição de exclusividade na chave de shard. Somente false é suportado. O padrão é false.
options	documento	Opcional. Um documento contendo campos opcionais, incluindo numInitialChunks, collation, zones e forceRedistribution.

O campo options suporta os seguintes campos:

Campo	Tipo	Descrição
numInitialChunks	inteiro	Opcional. Especifica o número inicial de chunks para criar em todos os shards no cluster ao refragmentar uma collection. O valor padrão é 90. Em seguida, o MongoDB cria e equilibra os chunks no cluster. numInitialChunks deve resultar em menos de 8192 por shard. Se você ver o erro "A chave de shard fornecida não tem cardinalidade suficiente para criar o número necessário de blocos", refaça a coleta com um valor numInitialChunks menor.
collation	documento	Opcional. Se a coleção especificada para reshardCollection tiver um agrupamento padrão, você precisa incluir um documento de agrupamento com { locale : "simple" }, senão o comando reshardCollection falha.
zones	array	Opcional. Especifica as zonas da collection. Para manter ou adicionar zonas, especifique as zonas da sua collection em uma array: [ { min: <document with same shape as shardkey>, max: <document with same shape as shardkey>, zone: <string> | null }, ... ]
forceRedistribution	booleano	Opcional. Se definida como true, a operação será executada mesmo que a nova chave de shard seja igual à chave de shard antiga. Use com a opção zones para mover dados para zonas específicas. Novidades na versão 8.0.

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

Considerações

As compilações de índice que ocorrem durante a refragmentação podem falhar silenciosamente.

• Não crie índices durante o processo de refragmentação.

• Não inicie o processo de refragmentação se houver construções de índice em andamento.

Processo de refragmentação

Em uma operação de refragmentação de collection, um fragmento (shard) pode ser um:

• doador, que atualmente armazena chunks para a coleção fragmentada.

• receptor, que armazena novos chunks para a coleção fragmentada com base nas chaves de fragmento e nas zonas.

Um shard pode ser doador e um receptor ao mesmo tempo.

O servidor de configuração primário é sempre o gerenciador de refragmentação e inicia cada fase da operação de refragmentação.

Exemplos

sh.reshardCollection( "sales.orders", { order_id: 1 } )

{
  ok: 1,
  '$clusterTime': {
    clusterTime: Timestamp(1, 1624887954),
    signature: {
      hash: Binary(Buffer.from("0000000000000000000000000000000000000000", "hex"), 0),
      keyId: 0
    }
  },
  operationTime: Timestamp(1, 1624887947)
}

sh.reshardCollection(
  "sales.orders",
  { order_id: 1 },
  { forceRedistribution: true }
)

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

sh.addShardToZone( "shard2", "NewZone" )
sh.addShardToZone( "shard3", "NewZone" )

sh.reshardCollection(
  "test.scores",
  { "studentId": 1, "testId": 1},
  { zones: [ {
    min: { "studentId": MinKey(), "testId": MinKey() },
    max: { "studentId": MaxKey(), "testId": MaxKey() },
    zone: "NewZone" }
    ]
} )

{
   ok: 1,
   '$clusterTime': {
   clusterTime: Timestamp( { t: 1699484530, i: 54 } ),
   signature: {
   hash: Binary.createFromBase64( "90ApBDrSSi4XnCpV3OWIH4OGO0Y=", 0 ),
   keyId: Long( "7296989036055363606" )
   } },
   operationTime: Timestamp( { t: 1699484530, i: 54 } )
}

Saiba mais

• Refragmentar uma collection