Cómo borrar una columna en PostgreSQL de forma segura (y recuperar una borrada por error)

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

ALTER TABLE … DROP COLUMN elimina la columna y todos sus valores, y una vez confirmado no hay SQL que la devuelva. PostgreSQL no reescribe la tabla (la columna queda marcada como borrada y su espacio se recupera en reescrituras posteriores), pero los datos ya no se pueden leer. Para recuperar los valores, restaura un backup o una recuperación point-in-time en una instancia aparte, vuelve a agregar la columna y copia los valores por clave primaria. En PostgreSQL, un DROP COLUMN dentro de una transacción abierta se deshace con ROLLBACK; en MySQL, el DDL hace commit implícito.

Cómo recuperar los datos

  • Detén el código que escribe en la tabla si depende de la columna, o revierte el deploy que la borró.
  • Restaura un backup o una recuperación point-in-time en una instancia aparte, en un momento justo antes del ALTER TABLE.
  • Vuelve a agregar la columna en producción (ALTER TABLE users ADD COLUMN email text;) y copia los valores desde la instancia restaurada por clave primaria, por ejemplo exportando id, email y ejecutando un UPDATE … FROM desde una tabla de staging.

Por qué pasa

Las columnas se borran en migraciones que limpian el esquema, y el riesgo está en el momento: la columna todavía la lee el código en ejecución, otro servicio, una vista o un reporte. Un drop también puede llegar sin ninguna revisión: un ORM que sincroniza el esquema desde los modelos, o un agente de IA que cambia el esquema mientras investiga otra cosa.

Cómo corregirlo

Borra una columna en dos versiones. Primero deja de usarla: quítala del código (en Rails, self.ignored_columns; en otros ORMs, quítala del modelo) y despliega. Después bórrala en una migración posterior, cuando nada la lea. En una tabla de PostgreSQL con tráfico, define un lock timeout, porque el ALTER TABLE necesita un lock exclusivo y esperarlo bloquea todas las queries que vienen detrás:

SET lock_timeout = '5s';
ALTER TABLE users DROP COLUMN IF EXISTS email;

En MySQL 8.0.29 y posteriores, DROP COLUMN admite ALGORITHM=INSTANT.

Cuando un agente de IA borra la columna

En anthropics/claude-code#46684, un agente de programación al que solo se le pidió investigar ejecutó dos sentencias ALTER TABLE … DROP COLUMN contra una base de producción en uso. Nadie las revisó porque nunca pasaron por un archivo de migración ni por un pull request: el agente las envió por su propia conexión. Ese es el caso que una revisión en CI no ve, y la razón por la que la misma regla también corre en runtime: a través del proxy, o de check_sql de MCP antes de que el agente ejecute, un DROP COLUMN se bloquea. En CI, donde una migración que borra una columna suele ser intencional, se marca para revisión.

Cómo evitar que vuelva a pasar

VERICTO-015 · ALTER TABLE DROP COLUMN · Severidad: Alta · Nodo del AST: AlterTableStmt > AlterTableCmd.subtype = DROP_COLUMN

La sentencia que la regla reporta

-- migrations/0045_drop_email.sql
ALTER TABLE users DROP COLUMN email;

Salida real de la CLI

$ npx @vericto/vericto-cli@2.3.0 check --offline migrations/0045_drop_email.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/0045_drop_email.sql  FLAGGED  VERICTO-015 high
    AlterTableStmt > AlterTableCmd.subtype = DROP_COLUMN
    fix: Use soft-delete (nullable column) or a versioned migration tool
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/0045_drop_email.sql
ALTER TABLE users ALTER COLUMN email DROP NOT NULL;
$ npx @vericto/vericto-cli@2.3.0 check --offline migrations/0045_drop_email.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-015" => find(stmts, |s| {
    s.kind == StatementKind::AlterTable
        && matches!(s.alter_table_kind, Some(AlterTableKind::DropColumn))
})
.map(|s| {
    let mut v = violation(
        rule,
        s,
        Some("Use soft-delete (nullable column) or a versioned migration tool".to_string()),
    );
    v.ast_node_path = "AlterTableStmt > AlterTableCmd.subtype = DROP_COLUMN".to_string();
    v
}),

Preguntas frecuentes