Después de ALTER TABLE users RENAME COLUMN name TO full_name; toda consulta que todavía dice name falla con ERROR: column "name" does not exist. No se perdieron datos: un renombre solo cambia el catálogo. La salida más rápida es volver a renombrarla (ALTER TABLE users RENAME COLUMN full_name TO name;) y rehacer el cambio en pasos que el código en ejecución pueda soportar.
Por qué pasa
La base cambia al instante, pero el código que la usa no: la versión anterior de la aplicación sigue corriendo durante el deploy, otros servicios, reportes y cachés del ORM siguen usando el nombre viejo, y un rollback de la aplicación trae de vuelta código que espera name. Renombrar una tabla tiene el mismo efecto en cada consulta que la nombra.
Cómo corregirlo
Usa expand/contract en lugar de un renombre: agrega la columna nueva, escribe en ambas, completa los datos, mueve las lecturas y borra la columna vieja solo cuando nada la use.
ALTER TABLE users ADD COLUMN full_name text;
UPDATE users SET full_name = name WHERE full_name IS NULL;
-- despliega código que lee full_name y, más adelante:
-- ALTER TABLE users DROP COLUMN name;En una tabla grande, completa los datos por lotes.
Cómo evitar que vuelva a pasar
VERICTO-016 · ALTER TABLE RENAME (tabla o columna) · Severidad: Alta · Nodo del AST: AlterTableStmt > Rename
La sentencia que la regla reporta
-- migrations/0046_rename_name.sql
ALTER TABLE users RENAME COLUMN name TO full_name;
Salida real de la CLI
$ npx @vericto/vericto-cli@2.3.0 check --offline migrations/0046_rename_name.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/0046_rename_name.sql FLAGGED VERICTO-016 high
AlterTableStmt > Rename
fix: Use a versioned migration tool and update all code references first
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.
La versión corregida
-- migrations/0046_rename_name.sql
ALTER TABLE users ADD COLUMN full_name text;
$ npx @vericto/vericto-cli@2.3.0 check --offline migrations/0046_rename_name.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-016" => find(stmts, |s| {
s.kind == StatementKind::AlterTable
&& matches!(s.alter_table_kind, Some(AlterTableKind::Rename))
})
.map(|s| {
let mut v = violation(
rule,
s,
Some("Use a versioned migration tool and update all code references first".to_string()),
);
v.ast_node_path = "AlterTableStmt > Rename".to_string();
v
}),
Preguntas frecuentes
Reglas relacionadas
- VERICTO-015: ALTER TABLE DROP COLUMN
- VERICTO-018: ALTER TABLE ALTER COLUMN TYPE
- VERICTO-017: ALTER TABLE DROP CONSTRAINT (FK/PK/CHECK)