INSERT sin lista de columnas: por qué se rompe cuando cambia el esquema

VERICTO-060 Baja En CI (CLI offline): MONITORED

INSERT INTO users VALUES (1, 'ana@example.com'); pone los valores en las columnas de la tabla según su orden actual. Hoy no se pierde nada, pero cuando se agrega una columna falla (PostgreSQL: INSERT has more expressions than target columns o un error de tipo; MySQL: Column count doesn't match value count at row 1), y si se reordenan las columnas puede escribir valores en las equivocadas sin avisar. Lista las columnas.

Por qué pasa

Los archivos de seed, los fixtures y los scripts rápidos omiten la lista de columnas porque es más corto. La sentencia queda atada a la forma exacta de la tabla, y cualquier migración puede romper esa suposición.

Cómo corregirlo

Nombra siempre las columnas destino, para que la sentencia siga funcionando cuando se agregan columnas y falle con claridad cuando se borra una que usa:

INSERT INTO users (id, email) VALUES (1, 'ana@example.com');

Cómo evitar que vuelva a pasar

VERICTO-060 · INSERT sin columnas explícitas · Severidad: Baja · Nodo del AST: InsertStmt > Cols = NULL

La sentencia que la regla reporta

-- seed.sql
INSERT INTO users VALUES (1, 'ana@example.com');

Salida real de la CLI

$ npx @vericto/vericto-cli@2.3.0 check --offline seed.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.
• seed.sql  MONITORED  VERICTO-060 low
    InsertStmt > Cols = NULL
    fix: INSERT INTO users (col1, col2) VALUES ($1, $2)
0 blocked · 0 allowed · 0 flagged · 1 monitored   (ruleset standard@engine-5.1.0 · mode: offline (engine 5.1.0, 42 standard rules, no workspace policy))

La CLI la registra como MONITORED y sale con 0: es un aviso de baja severidad. Con --fail-on any el job falla también por estos.

La versión corregida

-- seed.sql
INSERT INTO users (id, email) VALUES (1, 'ana@example.com');
$ npx @vericto/vericto-cli@2.3.0 check --offline seed.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.
0 blocked · 1 allowed · 0 flagged · 0 monitored   (ruleset standard@engine-5.1.0 · mode: offline (engine 5.1.0, 42 standard rules, no workspace policy))

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-060" => find(stmts, |s| {
    s.kind == StatementKind::Insert && !s.insert_has_columns
})
.map(|s| {
    let rel = s.relation.as_deref().unwrap_or("{table}");
    let mut v = violation(
        rule,
        s,
        Some(format!("INSERT INTO {rel} (col1, col2) VALUES ($1, $2)")),
    );
    v.ast_node_path = "InsertStmt > Cols = NULL".to_string();
    v
}),

Preguntas frecuentes