Ir al contenido
← Ecosistema

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

  1. La situación

    Tu equipo afirma reglas del negocio: "ningún pedido queda sin cliente", "toda factura lleva impuesto", "el respaldo de anoche restaura".

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

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

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

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

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

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

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

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