Borraste una clave foránea: cómo restaurarla de forma segura

VERICTO-017 Alta En CI (CLI offline): FLAGGED

ALTER TABLE orders DROP CONSTRAINT orders_user_id_fkey; quita la regla de que cada orders.user_id apunta a un usuario existente. No se borra ninguna fila, pero desde ese momento la base acepta pedidos de usuarios que no existen. Vuelve a agregar la restricción cuanto antes; si mientras tanto se escribieron filas que la violan, límpialas primero.

Cómo recuperar los datos

  • Encuentra las filas que violan la regla: SELECT o.id FROM orders o LEFT JOIN users u ON u.id = o.user_id WHERE o.user_id IS NOT NULL AND u.id IS NULL;
  • Corrige o borra esas filas, según lo que espere la aplicación.
  • En PostgreSQL, vuelve a agregar la restricción sin un lock largo: ALTER TABLE orders ADD CONSTRAINT orders_user_id_fkey FOREIGN KEY (user_id) REFERENCES users (id) NOT VALID; y después ALTER TABLE orders VALIDATE CONSTRAINT orders_user_id_fkey;

Por qué pasa

Las restricciones se borran para que una carga masiva, un arreglo de datos o una migración "pase" cuando choca con una violación, y el paso que las vuelve a crear se olvida o falla. Borrar una clave primaria o una restricción unique también borra el índice que la respalda, así que las consultas que dependían de él se vuelven lentas.

Cómo corregirlo

Trata una restricción como parte del esquema: bórrala solo en una migración versionada y revisada que diga por qué, y vuelve a crearla en el mismo cambio si el borrado es temporal. Cuando una carga choca con violaciones, corrige los datos en lugar de la restricción. Para cambiar una restricción, agrega primero la nueva (con NOT VALID en PostgreSQL y después VALIDATE) y borra la vieja al final.

Cómo evitar que vuelva a pasar

VERICTO-017 · ALTER TABLE DROP CONSTRAINT (FK/PK/CHECK) · Severidad: Alta · Nodo del AST: AlterTableStmt > DropConstraint

La sentencia que la regla reporta

-- migrations/0047_drop_fk.sql
ALTER TABLE orders DROP CONSTRAINT orders_user_id_fkey;

Salida real de la CLI

$ npx @vericto/vericto-cli@2.3.0 check --offline migrations/0047_drop_fk.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.
! migrations/0047_drop_fk.sql  FLAGGED  VERICTO-017 high
    AlterTableStmt > DropConstraint
    fix: Drop constraints only via a reviewed, versioned migration
0 blocked · 0 allowed · 1 flagged · 0 monitored   (ruleset standard@engine-5.1.0 · mode: offline (engine 5.1.0, 42 standard rules, no workspace policy))

En un archivo de migración la CLI la marca como FLAGGED y sale con 0: un cambio de esquema en una migración suele ser intencional, así que se señala para revisión en lugar de bloquearse. Con --fail-on flag (o fail_on = "flag" en .vericto.toml) sale con 1 y el job falla. Fuera de una migración (--sql, stdin u otro archivo) la bloquea, como el proxy y check_sql de MCP.

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-017" => find(stmts, |s| {
    s.kind == StatementKind::AlterTable
        && matches!(s.alter_table_kind, Some(AlterTableKind::DropConstraint))
})
.map(|s| {
    let mut v = violation(
        rule,
        s,
        Some("Drop constraints only via a reviewed, versioned migration".to_string()),
    );
    v.ast_node_path = "AlterTableStmt > DropConstraint".to_string();
    v
}),

Preguntas frecuentes