O VACUUM remove versões mortas de linhas, as cópias antigas que UPDATE e DELETE deixam na tabela, e marca o espaço delas como livre para novas linhas. VACUUM ANALYZE também atualiza as estatísticas que o planejador usa. VACUUM FULL reescreve a tabela inteira para devolver espaço ao sistema operacional. O autovacuum, ligado por padrão, roda VACUUM e ANALYZE para você em segundo plano.
Depois do DELETE, a tabela tem 700 linhas vivas e 300 mortas; depois do VACUUM, 0 linhas mortas. As views de estatísticas atualizam com atraso; pg_stat_force_next_flush() (PostgreSQL 15+) faz com que atualizem na hora para esta demonstração.
Por que o PostgreSQL deixa linhas mortas
O PostgreSQL mantém versões antigas das linhas para que cada transação veja um snapshot consistente (MVCC). Um UPDATE grava uma nova versão da linha e marca a antiga como expirada; um DELETE só marca. A versão antiga fica até que nenhuma transação em andamento possa precisar dela, e então o VACUUM pode removê-la. O ctid, a posição física de uma linha, mostra a mudança:
A linha 1 começa em (0,1), página 0 posição 1, e depois do update passa a ficar em (0,3). A posição 1 ainda guarda a versão antiga até ser limpa. Uma tabela atualizada com frequência produz linhas mortas o tempo todo, então o autovacuum volta a ela sempre.
VACUUM vs VACUUM FULL
O VACUUM simples deixa o arquivo com o mesmo tamanho: o espaço livre fica na tabela para inserts futuros. O VACUUM FULL grava uma cópia nova e compacta e descarta o arquivo antigo.
VACUUM | VACUUM FULL | |
|---|---|---|
| Lock | permite leituras e escritas | bloqueia todo acesso |
| Espaço | reutilizado pela mesma tabela | devolvido ao sistema operacional |
| Disco extra necessário | não | espaço para uma cópia inteira da tabela |
| Quando | rotineiramente (o autovacuum faz isso) | raramente, depois de apagar a maior parte de uma tabela grande |
As opções vão entre parênteses:
VACUUM (VERBOSE, ANALYZE) items;mostra o que foi feito e atualiza as estatísticas.VACUUM (PARALLEL 4)(PostgreSQL 13+) faz vacuum dos índices com workers paralelos.VACUUM (SKIP_LOCKED)pula as tabelas que não consegue travar na hora.
Como o autovacuum decide quando rodar
O autovacuum verifica cada tabela a cada autovacuum_naptime. Ele faz vacuum da tabela quando as linhas mortas passam de autovacuum_vacuum_threshold + autovacuum_vacuum_scale_factor * table rows: com os padrões, 50 linhas mais 20 por cento da tabela. Ele analisa a tabela quando as linhas alteradas desde a última análise passam de 50 mais 10 por cento. Desde o PostgreSQL 13, só inserts também disparam um vacuum. Os padrões no postgresql.conf:
autovacuum = on
autovacuum_naptime = 1min
autovacuum_max_workers = 3
autovacuum_vacuum_threshold = 50
autovacuum_vacuum_scale_factor = 0.2
autovacuum_vacuum_insert_threshold = 1000
autovacuum_vacuum_insert_scale_factor = 0.2
autovacuum_analyze_threshold = 50
autovacuum_analyze_scale_factor = 0.1
Numa tabela com 100 milhões de linhas, 20 por cento significa 20 milhões de linhas mortas antes de um vacuum começar. Reduza o scale factor só nas tabelas grandes e movimentadas:
ALTER TABLE events RESET (autovacuum_vacuum_scale_factor); devolve a tabela à configuração geral do servidor. O capítulo de vacuum de rotina cobre os demais parâmetros.
Ver o que o autovacuum fez
pg_stat_user_tables mostra as linhas mortas e o último vacuum manual e automático de cada tabela:
SELECT relname, n_live_tup, n_dead_tup, last_vacuum, last_autovacuum, last_autoanalyze
FROM pg_stat_user_tables
ORDER BY n_dead_tup DESC
LIMIT 10;
Se as linhas mortas continuam crescendo mesmo com o autovacuum rodando, procure transações abertas antigas, que o impedem de remover qualquer coisa mais nova que o snapshot delas:
SELECT pid, state, xact_start, query
FROM pg_stat_activity
WHERE xact_start < now() - interval '10 minutes'
ORDER BY xact_start;
Congelamento e wraparound dos IDs de transação
Os IDs de transação são contadores de 32 bits que dão a volta. Para manter as linhas antigas visíveis, o vacuum as congela, marcando-as como mais antigas que qualquer transação. Quando o ID não congelado mais antigo de uma tabela passa de autovacuum_freeze_max_age (200 milhões de transações por padrão), o autovacuum roda nela mesmo que esteja desligado.
Se mesmo assim o congelamento ficar muito para trás, o PostgreSQL para de atribuir novos IDs de transação, e as escritas falham até um vacuum colocar tudo em dia. Esta consulta mostra o quanto cada banco está perto disso:
SELECT datname, age(datfrozenxid) FROM pg_database ORDER BY 2 DESC;
Perguntas frequentes
O VACUUM trava a tabela?
O VACUUM simples pega um lock que ainda permite SELECT, INSERT, UPDATE e DELETE; ele só conflita com mudanças de schema, criação de índices, ANALYZE e outros vacuums. O VACUUM FULL pega um lock ACCESS EXCLUSIVE, que bloqueia todas as consultas na tabela até terminar.
Devo desligar o autovacuum?
Não. Sem ele, as linhas mortas se acumulam, as estatísticas ficam velhas e uma hora o banco precisa parar de aceitar escritas para evitar o wraparound dos IDs de transação. Ajuste os limites dele por tabela.
Por que minha tabela não diminui depois do VACUUM?
O VACUUM simples marca o espaço das linhas mortas como livre para novas linhas na mesma tabela; ele só devolve espaço ao sistema operacional quando as páginas vazias estão no fim do arquivo. O VACUUM FULL reescreve a tabela e devolve o espaço.
Por que o VACUUM não remove as linhas mortas?
Uma linha só pode ser removida quando nenhuma transação em andamento ainda pode precisar dela. Uma transação aberta há muito tempo (muitas vezes uma sessão ociosa que rodou BEGIN), um replication slot antigo ou uma prepared transaction abandonada seguram essas linhas.