Un bloque DO de PostgreSQL ejecutó sentencias que nadie revisó

VERICTO-081 Crítica En CI (CLI offline): BLOCKED

DO $$ BEGIN DELETE FROM users; END $$; ejecuta una sola vez un cuerpo procedural, y ese cuerpo puede contener cualquier cosa: aquí, un DELETE sin WHERE. Desde afuera es un solo texto opaco, así que las revisiones y las herramientas que leen la sentencia no ven lo que hace. Si el bloque cambió datos que no querías cambiar, recupéralos como cualquier otro cambio masivo.

Cómo recuperar los datos

  • Si el bloque DO corrió dentro de una transacción que sigue abierta, ejecuta ROLLBACK.
  • Lee el cuerpo del bloque para ver exactamente qué tablas tocó; la sentencia DO no devuelve una cantidad de filas.
  • Detén a quienes escriben en esas tablas, restaura una copia a un punto en el tiempo justo anterior al bloque en una instancia separada y copia de vuelta las filas afectadas por clave primaria.

Por qué pasa

DO es práctico para arreglos puntuales que necesitan un bucle o una condición, así que aparece en scripts de hotfix y en migraciones. Esa misma comodidad hace que una sentencia destructiva pueda quedar dentro de SQL dinámico (EXECUTE format(...)) o de un bucle, donde nada fuera del bloque la ve.

Cómo corregirlo

Reemplaza el bloque por las sentencias explícitas que ejecuta, para que cada una se pueda leer, revisar y comprobar:

DELETE FROM users WHERE id = 42;

Cuando de verdad necesites lógica procedural, ponla en una función con nombre creada por una migración revisada, y llámala con argumentos que limiten lo que toca.

Cómo evitar que vuelva a pasar

VERICTO-081 · Bloque de código anónimo DO · Severidad: Crítica · Nodo del AST: DoStmt

La sentencia que la regla reporta

-- fix.sql
DO $$ BEGIN DELETE FROM users; END $$;

Salida real de la CLI

$ npx @vericto/vericto-cli@2.3.0 check --offline fix.sql
note: offline mode: 42 standard rules at default severities, engine 5.1.0. Custom rules, overrides, sensitive columns, allowlists and the audit trail apply online only.
✖ fix.sql  BLOCKED  VERICTO-081 critical
    DoStmt
    fix: Replace the anonymous DO block with explicit, reviewable statements
1 blocked · 0 allowed · 0 flagged · 0 monitored   (ruleset standard@engine-5.1.0 · mode: offline (engine 5.1.0, 42 standard rules, no workspace policy))

✖ Vericto blocked 1 statement  (ruleset standard@engine-5.1.0 · mode: offline (engine 5.1.0, 42 standard rules, no workspace policy))
  ✖ fix.sql  BLOCKED  VERICTO-081 critical
      DoStmt
      fix: Replace the anonymous DO block with explicit, reviewable statements

This is Vericto enforcing a rule — the exit code is intentional, not a crash.
To allow a finding on purpose, add an inline comment on the statement:
    -- vericto:ignore[VERICTO-081] <reason>   (a reason is required)

La CLI la bloquea y sale con código 1, así que el job de CI falla antes del merge.

Pruébalo gratis, sin cuenta

La CLI revisa tus archivos .sql en tu máquina con las 42 reglas estándar: sin registro, sin API key y sin que el SQL salga de tu equipo. Es open source (AGPL-3.0-only).

npx @vericto/vericto-cli@2.3.0 check --offline migrations/

En cada pull request

La GitHub Action vericto/check-sql (Apache-2.0) corre la misma revisión offline sobre los archivos .sql que cambia el PR y anota los hallazgos en el PR. Guárdala como .github/workflows/vericto.yml:

on: pull_request
jobs:
  vericto:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
        with: { fetch-depth: 0 }
      - uses: vericto/check-sql@v1
        with: { offline: true, upload-sarif: false }

En runtime, para agentes de IA

El SQL que escribe un agente de IA no pasa por un PR. El proxy TCP de Vericto revisa cada sentencia entre la aplicación o el agente y la base de datos, y la herramienta check_sql de MCP deja que el agente compruebe el SQL antes de ejecutarlo. Los dos usan el perfil de runtime, que también bloquea los cambios de esquema.

La condición AST en el engine

La regla es un predicado determinístico sobre el AST, en src/rules/evaluator.rs del engine open source (AGPL-3.0-only), en el commit de esta página:

"VERICTO-081" => find(stmts, |s| s.kind == StatementKind::DoBlock)
    .map(|s| {
        let mut v = violation(
            rule,
            s,
            Some("Replace the anonymous DO block with explicit, reviewable statements".to_string()),
        );
        v.ast_node_path = "DoStmt".to_string();
        v
    }),

Preguntas frecuentes