Comprobar la cobertura del visibility map y la eficiencia de Index Only Scan
PostgreSQLMantenimientoComando
-- Tables with a low all-visible page ratio: Index Only Scans must visit the heap
SELECT c.oid::regclass AS table_name,
c.relpages,
c.relallvisible,
round(100.0 * c.relallvisible / NULLIF(c.relpages, 0), 1) AS all_visible_pct,
pg_size_pretty(pg_relation_size(c.oid)) AS heap_size,
s.n_ins_since_vacuum,
s.last_autovacuum
FROM pg_class c
JOIN pg_stat_user_tables s ON s.relid = c.oid
WHERE c.relpages > 1000
ORDER BY all_visible_pct NULLS FIRST
LIMIT 20;
-- If "Heap Fetches" in the plan is close to the returned rows, the visibility map is stale
EXPLAIN (ANALYZE, BUFFERS) SELECT id FROM customer WHERE id BETWEEN 1 AND 50000;
-- Exact count (pg_visibility extension)
CREATE EXTENSION IF NOT EXISTS pg_visibility;
SELECT * FROM pg_visibility_map_summary('customer');Qué hace
Muestra la proporción de páginas all-visible de las tablas, las filas insertadas desde el último vacuum y con qué frecuencia un Index Only Scan tuvo que visitar el heap (Heap Fetches).
Cuándo usarlo
Cuando un Index Only Scan rinde por debajo de lo esperado; en tablas con muchas inserciones/append-only y al validar el diseño de un índice covering (INCLUDE).
Precaución
relpages/relallvisible son estimaciones registradas por el último VACUUM/ANALYZE. Solo VACUUM activa los bits del visibility map; cada UPDATE/DELETE borra el bit de la página afectada. Para una proporción baja en tablas que se actualizan con frecuencia, reduzca autovacuum_vacuum_scale_factor por tabla. pg_visibility_map_summary lee el pequeño fork VM, no el heap.