mesclarAllChunksOnShard
Definição
mergeAllChunksOnShard
mergeAllChunksOnShard
encontra e mescla todos os chunks mescláveis que um shard possui para uma determinada collection.
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
Importante
Este comando não é suportado em instâncias sem servidor. Para obter mais informações, 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
O comando tem a seguinte sintaxe:
db.adminCommand( { mergeAllChunksOnShard: <name of the collection>, shard: <name of the shard>, maxNumberOfChunksToMerge: <maximum number of chunks to merge> /* optional */ } )
Campos de comando
O comando utiliza os seguintes campos:
Campo | Tipo | necessidade | Descrição |
---|---|---|---|
| string | Obrigatório | Nome da collection. |
| string | Obrigatório | Nome do fragmento. |
| inteiro | Opcional | Número máximo de partes a serem mesclados. |
Comportamento
mergeAllChunksOnShard
encontra e mescla todas as partes mescláveis para uma collection no mesmo shard. Dois ou mais parte contíguos na mesma collection são mescláveis quando atendem a todas estas condições:
Eles pertencem ao mesmo fragmento.
Eles não são pedaços gigantescos. As partes
jumbo
não podem ser mescladas porque não podem participar de migrações.O histórico deles pode ser limpo com segurança, sem interromper transações e leituras de snapshots:
A última migração envolvendo a parte aconteceu há pelo menos tantos segundos quanto o valor de
minSnapshotHistoryWindowInSeconds
.A última migração envolvendo a parte aconteceu há pelo menos tantos segundos quanto o valor de
transactionLifetimeLimitSeconds
.
Exemplo
Este exemplo pressupõe que o histórico esteja vazio para todos os blocos e que todos os blocos não sejam jumbo. Como ambas as condições são verdadeiras, todos os intervalos contíguos no mesmo shard são mescláveis.
Configurar
Esses chunks pertencem a uma coleção chamada coll
com chave de fragmento x
. São nove pedaços no total.
ID do bloco | Min | Máx | Fragmento |
---|---|---|---|
uma |
|
| Fragmento0 |
B |
|
| Fragmento0 |
C |
|
| Fragmento0 |
D |
|
| Fragmento0 |
E |
|
| Shard1 |
F |
|
| Shard1 |
G |
|
| Fragmento0 |
H |
|
| Fragmento0 |
i |
|
| Shard1 |
Passos
Resultado
Depois que esses comandos forem concluídos, os blocos contíguos serão mesclados. Há quatro partes no total em vez das nove originais.
ID do bloco | Min | Máx | Fragmento |
---|---|---|---|
A-B-C-D |
|
| Fragmento0 |
E-F |
|
| Shard1 |
G-H |
|
| Fragmento0 |
i |
|
| Shard1 |