Ir al contenido
← Ecosistema

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.

  1. 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.

  2. 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.

  3. 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
Para el equipo técnico

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

  1. 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.

  2. 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).

  3. 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.

  4. 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.

psql · pg_promise_guardsql
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)
Pruébala Hablar