Higiene básica en PostgreSQL: por qué toda base de datos necesita statement_timeoutNota · digest del 31 de octubre
Plano técnico infográfico del timeout de transacciones en PostgreSQL con contador statement_timeout e interrupción de bloqueo.
Nota2 secciones≈ 3 min

Higiene básica en PostgreSQL: por qué toda base de datos necesita statement_timeout

En la administración de bases de datos relacionales existe una pesadilla clásica con la que tarde o temprano tropieza cualquier equipo en crecimiento. A mitad de la jornada laboral, el backend deja de responder de repente. Las gráficas de latencia tocan techo, el pool de conexiones de PgBouncer se satura y los logs se llenan de errores esperando un socket libre.

Abres la vista del sistema pg_stat_activity y encuentras al culpable: un desarrollador o alguien en prácticas lanzó en producción una consulta analítica con un JOIN sin índice. La consulta lleva 40 minutos dando vueltas, mantiene un Shared Lock sobre la tabla crítica de usuarios y ha dejado bloqueados en fila cientos de transacciones normales de la API.

Y ahora lo más sorprendente: en la configuración por defecto de PostgreSQL, el parámetro statement_timeout vale cero. Eso significa que el motor está dispuesto a ejecutar cualquier sentencia SQL absurda durante toda la eternidad, hasta que el servidor se quede sin memoria o sin CPU.

La propia documentación de PostgreSQL recomienda explícitamente acotar el tiempo máximo de vida de las sentencias a nivel de base de datos o de rol de usuario.

Cómo configurar los límites de protección correctamente

Poner un límite rígido en postgresql.conf para todo el clúster es un error peligroso, porque romperá de inmediato la utilidad de copias de seguridad pg_dump.

El enfoque correcto consiste en aplicar límites diferenciados por base de datos y por rol de servicio:

-- 1. Definimos un timeout global de seguridad para todas las sesiones nuevas de la base:
ALTER DATABASE my_production_db SET statement_timeout = '30s';

-- 2. Apretamos el límite para el usuario de servicio de la aplicación web (API):
ALTER ROLE api_user SET statement_timeout = '10s';

-- 3. Permitimos consultas más pesadas a los analistas:
ALTER ROLE analytics_worker SET statement_timeout = '300s';

-- 4. Quitamos por completo el límite al usuario encargado de los backups:
ALTER ROLE backup_admin SET statement_timeout = '0';

Mira lo que ocurre: si una petición del servicio web tarda más de 10 segundos, PostgreSQL la corta a la fuerza con el código de error 57014 (canceling statement due to statement timeout), libera al instante los bloqueos retenidos y salva al clúster del atasco.

Timeouts complementarios: adiós a las transacciones abandonadas

Además de statement_timeout, una protección seria requiere configurar otros dos parámetros críticos:

-- Cortar transacciones abandonadas por el cliente en estado abierto (idle in transaction):
ALTER DATABASE my_production_db SET idle_in_transaction_session_timeout = '60s';

-- Tiempo máximo de espera para adquirir un bloqueo exclusivo sobre tabla o fila:
ALTER DATABASE my_production_db SET lock_timeout = '15s';

Si la aplicación cliente abrió un BEGIN, ejecutó un UPDATE y se quedó colgada por un corte de red, idle_in_transaction_session_timeout cerrará la sesión al minuto, evitando que quede bloqueado el proceso de limpieza VACUUM.

Y si te toca aplicar una migración de esquema (DDL) planificada, puedes ampliar el timeout de forma local dentro de esa transacción concreta:

BEGIN;
SET LOCAL statement_timeout = '10min';
ALTER TABLE orders ADD COLUMN tracking_code text;
COMMIT;

Si quieres profundizar más en la observabilidad del motor, te recomiendo nuestro artículo sobre diagnóstico de cuellos de botella en PostgreSQL. Configurar estos timeouts protectores lleva literalmente dos minutos, pero te ahorra semanas de sustos cuando llegan los picos de carga.

Quiero un análisis detalladoLos votos ayudan a elegir qué analizar a fondo. Este material tiene 0 votos.
Fuentes · 2