Conceptos básicos de VACUUM

UPDATE y DELETE dejan versiones de filas muertas hasta que VACUUM recupera espacio y actualiza los mapas de visibilidad. PostgreSQL 18.4 no devuelve bytes de archivo al sistema operativo inmediatamente, excepto en casos especiales.

Receta

Tarjeta de referencia rápida - lista para copiar y pegar.

VACUUM (VERBOSE, ANALYZE) orders;
SELECT n_dead_tup, n_live_tup, last_vacuum, last_autovacuum
FROM pg_stat_user_tables
WHERE relname = 'orders';

Cuándo usar esto: La tabla crece después de eliminaciones, los escaneos secuenciales se ralentizan o los escaneos solo con índice dejan de aparecer.

Ejemplo de trabajo

CREATE TABLE orders (
  id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  status text NOT NULL,
  note text
);
 
INSERT INTO orders (status, note)
SELECT 'open', 'row-' || i FROM generate_series(1, 50000) i;
 
UPDATE orders SET status = 'closed' WHERE id % 2 = 0;
DELETE FROM orders WHERE id % 5 = 0;
 
SELECT relname, n_live_tup, n_dead_tup, last_vacuum
FROM pg_stat_user_tables
WHERE relname = 'orders';
 
VACUUM (VERBOSE) orders;
 
SELECT relname, n_live_tup, n_dead_tup, last_vacuum
FROM pg_stat_user_tables
WHERE relname = 'orders';

Lo que esto demuestra:

• Acumulación de tuplas muertas
• VACUUM marca el espacio como reutilizable dentro del archivo
• Monitorización a través de pg_stat_user_tables

Profundización

Cómo funciona

• MVCC mantiene las versiones de fila antiguas visibles para las transacciones abiertas.
• VACUUM escanea páginas, elimina tuplas muertas, congela horizontes xmin, actualiza FSM y el mapa de visibilidad.
• VACUUM FULL reescribe la tabla exclusivamente (riesgo de tiempo de inactividad); prefiera pg_repack para reducir el tamaño en línea.
• Autovacuum lanza trabajadores basándose en umbrales de n_dead_tup.

Variantes de VACUUM

Notas SQL

EXPLAIN (ANALYZE, BUFFERS)
SELECT count(*) FROM orders WHERE status = 'open';
-- El escaneo solo con índice necesita un mapa de visibilidad actualizado de vacuum

Trampas comunes

• Esperar que DELETE reduzca el disco inmediatamente - Los archivos permanecen grandes; el espacio se reutiliza para inserciones. Solución: pg_repack o eliminación de particiones para una reducción real.
• Desactivar autovacuum en tablas activas - Riesgo de wraparound del ID de transacción. Solución: Ajuste por tabla, no desactivar.
• Transacciones largas bloquean vacuum - Las tuplas muertas no se pueden eliminar. Solución: Matar sesiones inactivas en transacción; establecer idle_in_transaction_session_timeout.
• Asumir que vacuum soluciona completamente el bloat del índice - Los índices necesitan rutas de limpieza separadas. Solución: REINDEX CONCURRENTLY o repack.
• Ejecutar VACUUM FULL en horas pico de producción - Acceso a bloqueo exclusivo. Solución: Ventana de mantenimiento o herramientas en línea.

Alternativas

Preguntas frecuentes

Relacionado

• Ajuste de Autovacuum - Umbrales de trabajadores
• Wraparound de ID de Transacción - Urgencia de congelación
• Bloat de Tablas e Índices - Medición
• Conceptos básicos de MVCC - Por qué existen las tuplas muertas

Versiones de Stack: Esta página fue escrita para PostgreSQL 18.4 (estable 18, mantenimiento 17), pgvector 0.8+, PgBouncer 1.x, Patroni 3.x, y PostGIS 3.5+.