Garantías del esquema
pg_promise_guard v0.2.10
Encuentra lo que tu esquema dice garantizar y dejó de garantizar en silencio.
Una migración corre CREATE UNIQUE INDEX CONCURRENTLY, falla por duplicados que ya estaban, y deja el índice atrás: marcado unique, marcado inválido. Desde ese momento \d dice UNIQUE, el ORM dice unique, la aplicación asume unique, y nada se aplica. Los duplicados siguen entrando.
Instalar
CREATE EXTENSION pg_promise_guard; En simple
Encuentra las garantías que tu base de datos dice tener y que, en silencio, dejó de cumplir.
- La situación
Tu sistema promete que no puede haber dos clientes con el mismo RUT, y que cada cambio queda en la auditoría.
- Sin esta pieza
Una actualización del sistema falló a medias y dejó esas reglas desactivadas. Todo se ve igual que antes. Los duplicados entran y la auditoría no registra nada.
- Con esta pieza
Un chequeo tan barato que se puede correr cada minuto lista cada garantía rota, y dice si es grave (está entrando dato malo ahora) o transitoria (a mitad de un cambio planificado).
Por qué importa si decides
- Un sí o no para el monitoreo: "las promesas se cumplen" o "no"
- Distingue lo grave de lo transitorio, para que nadie silencie la alerta
- No toca tus datos: solo lee cómo está configurada la base
El problema
El fallo fue ruidoso una vez; el estado roto es silencioso para siempre
Un evento fuerte y único es exactamente lo que necesita un centinela periódico y no una alerta más.
No es amcheck: amcheck verifica que un índice válido sea estructuralmente sano. Estos índices son estructuralmente perfectos y simplemente no están en efecto. Pregunta distinta, respuesta distinta.
| Lo que el esquema dice | Lo que pasa |
|---|---|
| Índice UNIQUE | inválido: entran duplicados |
| Restricción CHECK / FOREIGN KEY | NOT VALID: las filas que ya estaban nunca se revisaron |
| Trigger de auditoría | DISABLED para una carga masiva, nunca re-habilitado |
| Row Level Security | ENABLED pero no FORCED: el dueño de la tabla se salta toda política |
Cómo funciona
Una vista, un booleano, dos severidades
- 01
promise_breaks
Una fila por garantía rota: kind, object, relation, severity. Solo lee catálogos del sistema: sin datos de usuario, sin locks, sin biblioteca compartida.
- 02
breach vs gap
breach: el esquema afirma una garantía que NO se está aplicando ahora; puede estar entrando dato malo mientras lees. gap: la garantía vale de aquí en adelante pero no cubre lo que ya había (un NOT VALID a mitad de migración es legítimo).
- 03
promises_kept()
Solo pasa a false con un breach. Un monitor que se pone rojo por un estado intermedio deliberado se silencia, y se lleva los breaches reales consigo.
- 04
Qué reporta desde 0.2.8
Además de índices inválidos, NOT VALID, triggers deshabilitados y RLS sin forzar: NOT ENFORCED (PostgreSQL 18), triggers de FK deshabilitados, política sobre tabla sin RLS, reglas y event triggers deshabilitados. Lee pg_catalog primero (0.2.7) para que nadie ciegue el escáner con un pg_trigger falso en public.
SQL
Uso
Seguro de correr en una base de producción ocupada y suficientemente barato como para correrlo cada minuto. Solo watch() necesita pg_living_assertions.
CREATE EXTENSION pg_promise_guard;
SELECT * FROM promise_breaks;
-- kind | object | relation | severity
-- ----------------------+-------------------------+-----------------+----------
-- invalid_unique_index | app.customers_tax_id_uk | app.customers | breach
-- disabled_trigger | app.audit_insert | app.invoices | breach
-- unenforced_rls | app.tenant_data | app.tenant_data | breach
-- not_valid_constraint | app.amount_positive | app.invoices | gap
SELECT promises_kept(); -- toda la base
SELECT promises_kept('app'); -- un esquema
SELECT * FROM check_promises('app'); Lo que garantiza
Lo que garantiza
- Corre bajo READ COMMITTED; un esquema que no existe es un error, no un parte limpio.
- Los objetos de una extensión del superusuario se saltan; una extensión que posee un tenant, no.
- Verde en 18.6 y 19beta2 con la misma salida esperada: nada depende de 19.
Lo que no hace
Lo que NO hace, declarado acá y no escondido en el número de versión
- Reporta estado, no historia: no puede decir cuándo el índice se invalidó ni quién deshabilitó el trigger.
- No revisa si un índice válido está corrupto: eso es amcheck.
- No mira permisos, sombreado de search_path ni privilegios por defecto, que también rompen lo que la gente llama "garantías".
- No ve session_replication_role = replica puesto por un superusuario: salta triggers y FKs sin dejar nada en el catálogo.
- No corre bajo PostgreSQL 11: META.json declara 11 como mínimo, y de 11 a 19 pasa installcheck (CI y revisión del 11-11-2026).
Para la empresa
Para la empresa
Es el centinela que convierte "tenemos unicidad / auditoría / RLS" en algo que se comprueba cada minuto y que el monitoreo entiende con un booleano.
- promises_kept() como check de salud en el monitoreo existente
- Diferencia breach de gap: no entrena al equipo a ignorar alertas
- Con pg_living_assertions, watch() registra el escaneo con su fecha
Ficha técnica
- Versión medida
- 0.2.10 (imagen pública 0.3.6, 13-11-2026)
- PostgreSQL
- 11 a 19 verdes (installcheck en la CI y en la revisión del 11-11-2026); META declara 11
- Depende de
- Nada; pg_living_assertions solo para watch()
- Licencia
- Apache-2.0
- Edición Enterprise
- Incluida (PostgreSQL 18)
Las otras piezas del ecosistema
- pg_agent_gate Agentes de IA sobre PostgreSQL
- pg_phasevec · preview 0.x Memoria vectorial con procedencia
- pg_living_assertions Garantías con fecha
- pg_plan_guard Planes de ejecución vigilados
- pg_recall_guard Recall de índices vectoriales
- pg_grammar_guard Salida estructurada que no inventa nombres
- ygg-agent v0.2.0 · PyPI El loop del agente sobre pg_agent_gate, sin MCP: el modelo escribe SQL y la base decide.