Refragmentar uma collection

Sobre esta tarefa

• Somente uma coleção pode ser refragmentada de cada vez.

• writeConcernMajorityJournalDefault deve ser true.

• Para refragmentar uma collection que tenha uma restrição de exclusividade, a nova chave de shard deve satisfazer os requisitos de índice únicos para quaisquer índices únicos existentes.

• Os comandos a seguir e os métodos de shell correspondentes não são compatíveis com a collection que está sendo refragmentada enquanto a operação de refragmentação está em andamento:

  • collMod

  • convertToCapped

  • createIndexes

  • createIndex()

  • drop

  • drop()

  • dropIndexes

  • dropIndex()

  • renameCollection

  • renameCollection()

• Se você executar uma das seguintes operações, ela aguardará até que a refragmentação seja concluída antes de ser executada:

  • addShard

  • removeShard

  • dropDatabase no banco de dados que hospeda a coleção que está passando por refragmentação

• Se a collection que você está refragmentando usar MongoDB Search, o índice de pesquisa ficará indisponível quando a operação de refragmentação for concluída. Você precisa refragmentar manualmente o índice de pesquisa assim que a operação de refragmentação for concluída.

• If the collection you're resharding is archived in Atlas Online Archives, the online archive files are marked as Orphaned once the resharding operation completes. You can create another online archive for the same database, collection, and fields as the orphaned archive as long as there is no other archive for that same combination in the Active state.

Antes de começar

Antes de começar a refragmentar sua coleção, certifique-se de atender aos seguintes requisitos:

• Seu aplicação pode tolerar um período de dois segundos em que a collection afetada bloqueia as gravações. Durante o período em que as gravações são bloqueadas, seu aplicação experimenta um aumento na latência.

  Se sua carga de trabalho não tolerar esse requisito, considere ajustar sua chave de fragmento.

• Seu banco de dados atende aos seguintes requisitos de recursos:

  • Certifique-se de que o espaço de armazenamento disponível em cada fragmento destinatário seja pelo menos duas vezes o tamanho de armazenamento da coleção que você deseja reparticionar os fragmentos mais seu tamanho de índice total, dividido pelo número de fragmentos:

    ( ( collection_storage_size + index_size ) * 2 ) / shard_count = storage_req

    Por exemplo, considere uma coleção com um tamanho de armazenamento de 2 TB de dados e um índice de 400 GB. Para distribuí-lo em quatro fragmentos, você precisa de:

    ( ( 2 TB collection + 0.4 TB index ) * 2 ) / 4 shards = 1.2 TB storage

    Para refragmentar esta coleção, cada fragmento requer 1.2 TB de armazenamento disponível.

    No MongoDB Atlas, talvez seja necessário atualizar para o próximo tier de armazenamento para a operação de refragmentação. Você pode fazer o downgrade assim que a operação for concluída.

  • Certifique-se de que sua capacidade de E/S esteja abaixo de 50%.

  • Certifique-se de que a carga da CPU esteja abaixo de 80%.

  Importante

  Esses requisitos não são exigidos pelo banco de dados. Uma falha na alocação de recursos suficientes pode resultar em:

  • o banco de dados ficar sem espaço e desligando

  • redução do desempenho

  • a operação demora mais que o esperado

  Se o seu aplicação tiver períodos com menos tráfego, execute esta operação na coleção durante esse período, se possível.

• Você não precisa criar um índice na nova chave de fragmento antes de refragmentar. A operação de refragmentação cria os índices necessários automaticamente durante a fase de indexação.

• Nenhuma construção de índice está em andamento. Para verificar se há construções de índice em execução, use $currentOp:

  db.getSiblingDB("admin").aggregate( [
     { $currentOp : { idleConnections: true } },
     { $match: {
           $or: [
               { "op": "command", "command.createIndexes": { $exists: true } },
               { "op": "none", "msg": /^Index Build/ }
           ]
        }
     }
  ] )

  No documento de resultado, se o valor do campo inprog for uma array vazia, não haverá nenhuma construção de índice em andamento:

  {
     inprog: [],
     ok: 1,
     '$clusterTime': { ... },
     operationTime: <timestamp>
  }

Passos

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.

db.adminCommand({
  reshardCollection: "<database>.<collection>",
  key: <shardkey>
})

db.adminCommand({
  reshardCollection: "<database>.<collection>",
  key: <shardkey>,
  forceRedistribution: true
})

db.getSiblingDB("admin").aggregate([
  { $currentOp: { allUsers: true, localOps: false } },
  {
    $match: {
      type: "op",
      "originatingCommand.reshardCollection": "<database>.<collection>"
    }
  }
])

[
  {
    shard: '<shard>',
    type: 'op',
    desc: 'ReshardingRecipientService | ReshardingDonorService | ReshardingCoordinatorService <reshardingUUID>',
    op: 'command',
    ns: '<database>.<collection>',
    originatingCommand: {
      reshardCollection: '<database>.<collection>',
      key: <shardkey>,
      unique: <boolean>,
      collation: { locale: 'simple' }
    },
    totalOperationTimeElapsedSecs: <number>,
    remainingOperationTimeEstimatedSecs: <number>,
    ...
  },
  ...
]

Comportamento

Erro de Case