Garantías con fecha
pg_living_assertions v0.5.10
Una garantía sin fecha de última comprobación es una creencia.
Un registro de lo que afirmas que es cierto sobre tu base, cada cosa con el SQL que lo prueba y la fecha en que se probó por última vez. El catálogo guarda el estado (indisvalid, convalidated, tgenabled) pero nunca la pregunta que importa: ¿sigue siendo cierto, y desde cuándo no miramos?
Instalar
CREATE EXTENSION pg_living_assertions; En simple
Una lista de las cosas que tu empresa da por ciertas sobre sus datos, con la prueba y la fecha de la última vez que alguien lo comprobó.
- La situación
Tu equipo afirma reglas del negocio: "ningún pedido queda sin cliente", "toda factura lleva impuesto", "el respaldo de anoche restaura".
- Sin esta pieza
Alguien las revisó una vez, hace meses. Hoy nadie sabe si siguen siendo ciertas, y "nadie lo ha revisado" se parece demasiado a "todo bien".
- Con esta pieza
Cada regla tiene su comprobación y se ejecuta cuando quieras. Ves "se cumple", "roto" o "nunca comprobado", siempre con la fecha. Una regla vieja sin revisar ya no pasa por sana.
Por qué importa si decides
- Evidencia para auditorías y para clientes: cada garantía con su prueba y su fecha
- "Nunca revisado" deja de parecer "todo bien": el sistema distingue siete estados, no dos
- Es la base sobre la que trabajan otras dos piezas del ecosistema
El problema
El mecanismo funciona y lo que lo registra miente
El índice sigue marcado UNIQUE mientras entran duplicados. La política RLS "protege" la tabla. La réplica "está al día". El respaldo "restaura". Son afirmaciones que alguien hizo un día y nadie volvió a comprobar.
No es una implementación de CREATE ASSERTION (SQL-92, no implementado en PostgreSQL): esas son restricciones sobre datos, evaluadas en cada escritura. Estas son aserciones sobre el estado del sistema, evaluadas cuando preguntas. Decir otra cosa sería vender lo que no es.
Cómo funciona
Declarar, correr, leer la edad junto al veredicto
- 01
declare(name, description, sql)
El check devuelve UNA fila con una columna booleana holds y, opcionalmente, un texto detail. Se reejecuta todo con run_all() o uno con run(name).
- 02
Siete estados, y los extra son el punto
holds, broken, unknown (corrió y no pudo decidir: NO es falso), erroring (el check mismo falla: un defecto, hasta arreglarlo no vigila nada), unchecked (nadie lo corrió nunca: NO es un parte limpio), retired (apagado a propósito, con razón y fecha), unregistered.
- 03
La edad viaja con el veredicto
status siempre reporta checked_at y age; stale(interval) lista lo que lleva demasiado, separando "nunca comprobado" de "comprobado hace mucho": solo uno se arregla esperando.
- 04
El SQL guardado corre sellado
Corre como el rol que lo declaró y, desde 0.5.10, no puede salir de él: lo que alcanza, lo alcanza con los derechos de su autor y no del llamador. Declarar una aserción es un privilegio.
SQL
Uso
state(), assert_holds() y stale() están abiertos a cualquier rol con USAGE en el esquema (un nombre, un veredicto, su edad). La vista status no: lleva el detail de cada check, que puede ser dato, y es del dueño concederla.
CREATE EXTENSION pg_living_assertions;
SELECT living_assertions.declare(
'no_orphaned_invoices',
'every invoice points at a customer that exists',
$$select count(*) = 0 as holds,
count(*) || ' orphaned invoices' as detail
from invoices i
left join customers c on c.id = i.customer_id
where c.id is null$$);
SELECT name, state, age FROM living_assertions.status; Lo que garantiza
Lo que garantiza
- state() nunca devuelve NULL ni un resultado vacío: ambos se leen como "bien".
- unknown no se colapsa en broken (así un monitor empieza a reportar lo que no sabe) ni unchecked en holds (así se confía en una garantía que nadie miró).
- Una aserción no se renegocia en el lugar: se declara de nuevo. Las de un consumidor que se borra pasan a erroring en vez de desaparecer: fuerte le gana a silencioso.
- declare_unchanged aprueba lo que una expresión evalúa hoy y avisa cuando cambia. Recibe la expresión, no el valor: un valor guardado se compararía consigo mismo para siempre.
- El registro de checks es append-only: desde 0.5.9 el servidor fecha tanto la aserción como el check, y TRUNCATE se rehúsa en ambas tablas.
- SQL puro: sin biblioteca compartida y sin dependencias.
Lo que no hace
Lo que no hace
- No hace nada correcto: te dice si algo que afirmaste sigue siendo cierto. No descubre afirmaciones que nadie escribió.
- No reemplaza restricciones: una restricción impide que entre un dato malo; una aserción viva avisa que una garantía dejó de aplicar.
- Alguien tiene que escribir el check, igual que un CHECK.
- unknown no es un diagnóstico: dice que el check no pudo decidir, no por qué.
- El sello no deshace lo que sale de la transacción: nextval() en una secuencia temporal, dblink, un FDW, una función no confiable que escribe un archivo, COPY TO PROGRAM.
- declare_unchanged compara el TEXTO del valor, y hacer canónico ese texto es trabajo tuyo: jsonb normaliza el orden de las claves; un arreglo no.
- No es pg_isok (de Karl O. Pinc, que el autor de esta extensión co-mantiene). pg_isok trabaja fila por fila, para que una persona revise lo dudoso; esta trabaja afirmación por afirmación y guarda un veredicto y cuándo se alcanzó.
Para la empresa
Para la empresa
Es evidencia para auditoría: cada garantía que el negocio asume sobre la base, con la prueba y la fecha. Y es la base de pg_promise_guard y pg_grammar_guard, que registran en ella lo que vigilan.
- Registro versionable de garantías con veredicto y edad, consultable por un monitor
- Sobrevive pg_dump + restore (make check-dump); quién puede guardar SQL que otro ejecutará está probado (make check-privs)
- Matriz de versiones medida con make installcheck en contenedores oficiales
Ficha técnica
- Versión medida
- 0.5.10 (imagen pública 0.3.6, 13-11-2026)
- PostgreSQL
- 11 a 19 verdes (medido 2026-09-16 y por CI en 0.5.0); 10 no soportado por diseño (EXECUTE FUNCTION)
- 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_plan_guard Planes de ejecución vigilados
- pg_recall_guard Recall de índices vectoriales
- pg_promise_guard Garantías del esquema
- 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.