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
Reglas relacionadas
- VERICTO-040: INSERT INTO … SELECT sin filtro
- VERICTO-061: INSERT batch con más de 10k filas
- VERICTO-016: ALTER TABLE RENAME (tabla o columna)