compactar (comando de banco de dados)

Monitoramento do progresso

Para verificar o progresso da operação compact, monitore o arquivo de registro mongod ou execute db.currentOp() em outra instância do shell.

Encerramento da operação

Se você encerrar o compact com o método db.killOp() ou reiniciar o servidor antes que a operação termine, o compact será encerrado. A operação pode não liberar espaço em disco de volta para o sistema operacional.

Espaço em disco

O comando compact reduz o espaço em disco para dados e índices em uma coleção, liberando blocos obsoletos para o sistema operacional. A eficácia depende de quantos blocos estão disponíveis para liberação e sua localização no arquivo de dados.

Para ver como o espaço de armazenamento muda na collection, execute o collStats comando antes e depois da compactação. Você pode usar a métrica collStats.freeStorageSize de saída para visualizar a quantidade de armazenamento disponível para reutilização.

A operação é iterativa, trabalhando em segmentos do arquivo de dados em cada passagem. Para estimar quanto espaço compact libera, use o sinalizador dryRun. Chamar compact em uma coleção compacta a coleção e seus índices associados.

compact podem exigir espaço em disco adicional para serem executados.

Backups

A compactação verifica regularmente o banco de dados, o que pode levar à sobrecarga de sincronização. Em bancos de dados de alto tráfego, isso pode atrasar ou impedir tarefas operacionais, como fazer backups. Para evitar interrupções inesperadas, desative a compactação antes de fazer um backup.

Conjuntos de réplicas

Você pode usar compact em coleções e índices em um conjunto de réplicas. Considere o seguinte:

• O nó primário não replica o comando compact para os secundários.

• Execute compact em nós secundários sempre que possível. Se você não puder executar compact nos secundários, consulte a opção force.

• Começando no MongoDB 6.1.0 (e 6.0.2):

  • Um nó secundário pode replicar enquanto compact estiver em execução.

  • Leituras permitidas.

Para executar compact em um cluster:

Diferenças de tamanho de índice entre membros

Cada nó aplica gravações em seus índices de forma independente. O tamanho do armazenamento do índice pode diferir entre os membros de um conjunto de réplicas, mesmo quando os membros contêm dados idênticos. Um nó primary aplica gravações diretamente de operações do cliente . Um nó secundário aplica as mesmas gravações do oplog, geralmente em lotes e ordem diferentes. Essas diferenças no padrão de gravação alteram a forma como o mecanismo de armazenamento empacota e comprime páginas de índice. Como resultado, um índice em um membro pode ficar maior no disco do que o mesmo índice em outro membro.

Para alinhar um índice afetado de volta com o mesmo índice em outros membros, use uma das seguintes opções de correção:

• Execute compact no nó afetado.

• Execute uma sincronização inicial do nó afetado.

• Descarte e recrie o índice afetado.

Ao planejar a capacidade de armazenamento para um conjunto de réplicas, considere essa variação no tamanho do índice entre os membros.

Clusters fragmentados

compact aplica-se apenas a mongod instâncias. Em um ambiente fragmentado, execute o compact em cada shard separadamente como uma operação de manutenção.

Você não pode emitir compact em relação a uma instância mongos.

Comandos compactos simultâneos não permitidos

Se você tentar executar vários comandos compact simultâneos na mesma coleção, o MongoDB retornará um erro.

Compactar uma coleção

A seguinte operação executa o comando compact na collection movies:

db.runCommand( { compact: "movies", force: true } )

{ bytesFreed: "...", ok: 1 }

Estimativa de compactação

A operação a seguir executa uma simulação do comando compact na coleção movies :

db.runCommand( {
   compact: "movies",
   dryRun: true,
   force: true
} )

{ estimatedBytesFreed: "...", ok: 1 }