¿drop_all() de SQLAlchemy corrió contra producción? Cómo recuperarte y alejar los tests

VERICTO-010

Base.metadata.drop_all(engine) borra cada tabla de la metadata que existe en la base a la que apunta el engine. Es un paso normal de teardown en los tests, y destruye datos cuando el engine resuelve a producción, casi siempre porque el proceso de tests cargó el .env o el DATABASE_URL de producción. Si pasó, detén el runner de tests y los servicios, y restaura a un momento justo antes de la corrida: create_all() vuelve a crear las tablas, no las filas.

Recupera los datos ahora

  • Detén el agente o el proceso. Cierra la sesión del agente, cancela cualquier tarea en segundo plano y detén la corrida de tests, el job de deploy o el servicio que ejecutó el comando, para que nada vuelva a correr contra la base que vas a restaurar.
  • No ejecutes más migraciones, pushes ni resets, y no dejes que el agente "repare" el esquema. Volver a crear las tablas trae tablas vacías, no las filas. Anota cuándo corrió el comando destructivo (en la transcripción del agente, el historial de la shell o el log de la base): todos los restores de abajo necesitan ese momento.
  • Restaura a un momento justo antes del comando, en una instancia aparte. PostgreSQL propio: restaura el base backup y reproduce el WAL archivado con recovery_target_time justo antes; un archivo de pg_dump solo restaura al momento en que se tomó. Amazon RDS / Aurora: "Restore to point in time" crea una instancia nueva (RDS) o un clúster nuevo (Aurora) en cualquier momento dentro del período de retención de backups, sin modificar el original. Neon: instant restore lleva una rama raíz a un momento dentro de su history window. Supabase: los backups diarios y, donde está activada, la recuperación point-in-time están en Database → Backups. Railway: los backups de volumen, si se crearon o programaron, se restauran desde el servicio. MySQL: restaura el último backup completo y reproduce el binary log con mysqlbinlog hasta justo antes del evento destructivo.
  • Revisa la copia restaurada y después llévala de vuelta. Compara la cantidad de filas y las últimas filas con lo que esperas, y después apunta la aplicación a la instancia restaurada o copia las tablas de vuelta (pg_dump -t tabla desde la instancia restaurada). Las filas escritas entre el punto de restore y ahora se vuelven a aplicar a mano.
  • ¿No hay backup ni recuperación point-in-time? Busca otras copias: una base de staging o de desarrollo, una réplica de lectura, exports, un data warehouse o los sistemas de donde vinieron los datos.

Por qué pasó

Según la documentación de SQLAlchemy, MetaData.drop_all() borra todas las tablas guardadas en la metadata y, por defecto (checkfirst=True), saltea las que no están en la base de destino; tables=[…] lo limita a un subconjunto. No sabe nada de entornos: borra en el engine que recibe. El engine suele salir de una variable de entorno, así que una corrida de tests con el .env de producción cargado, desde un directorio de deploy o una shell compartida, desarma producción. Un desarrollador reportó exactamente eso con un agente de IA ejecutando los tests (openai/codex#42480).

Haz que el fixture de test rechace producción

Dale a los tests su propia variable y haz que el fixture compruebe dónde está por borrar tablas, para que un entorno equivocado falle antes del teardown:

import os
import pytest
from sqlalchemy import create_engine

@pytest.fixture
def engine():
    url = os.environ["TEST_DATABASE_URL"]  # nunca DATABASE_URL
    engine = create_engine(url)
    if not (engine.url.database or "").endswith("_test"):
        pytest.exit(f"refusing to drop tables in {engine.url.database}")
    Base.metadata.create_all(engine)
    yield engine
    Base.metadata.drop_all(engine)

Esto protege los fixtures que escribes tú. No protege un test que escribió otra persona, o que escribe un agente, y por eso la conexión en sí no debería llegar a producción.

Cómo evitarlo

drop_all() envía un DROP TABLE por tabla por la conexión del engine. Cuando el único camino a producción es el proxy, esas sentencias se bloquean antes de llegar a la base, así que una corrida de tests que resuelve a producción falla en lugar de vaciarla.

Vericto revisa cada sentencia SQL sobre su AST antes de que llegue a la base de datos. Estas son las reglas que reportan las sentencias de este incidente, con la salida real de la CLI sobre el ejemplo de cada regla:

VERICTO-010: DROP TABLE o DROP DATABASE

El ejemplo de la regla · Crítica

-- migrations/0042_drop_users.sql
DROP TABLE users;

Salida real de la CLI

$ npx @vericto/vericto-cli@2.3.0 check --offline migrations/0042_drop_users.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/0042_drop_users.sql  FLAGGED  VERICTO-010 critical
    DropStmt
    fix: Use a versioned migration tool (Flyway, Prisma Migrate, Alembic, Rails migrations)
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.

Configura el agente para que pase por Vericto

  1. Conecta el agente a la base a través del proxy. Su URL de conexión apunta al proxy TCP de Vericto, no a la base. El proxy revisa cada sentencia, incluidas las que envía un comando del ORM que ejecute el agente, y en runtime bloquea los DROP, TRUNCATE y ALTER … DROP COLUMN antes de que lleguen a la base. Para un agente de programación, vericto-proxy mcp le da execute_sql, describe_schema y check_sql, nunca la credencial de la base.
  2. Mantén la credencial directa de producción lejos del agente. Que no esté en el .env, en la shell ni en el entorno que cargan el agente y sus corridas de tests. Si el agente tiene otra forma de llegar a la base, el proxy no lo ve.
  3. Dale un rol de solo lectura a través de Vericto. El rol detrás de vericto-proxy mcp es de solo lectura (el SQL para crearlo está en la documentación de MCP), y el acceso de agentes fija a cada agente en solo lectura sobre las tablas que eliges.
  4. Deja que el agente compruebe el SQL antes de ejecutarlo con la herramienta check_sql de MCP: recibe el veredicto, la regla y la corrección sugerida.

En CI, sobre los archivos de migración

Un fixture de test no produce un archivo .sql, así que CI no puede ver un drop_all(). Tus migraciones de Alembic sí se pueden revisar: alembic upgrade head --sql escribe el SQL que ejecutarían (modo offline), y la Action revisa ese archivo en el 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. 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 }

O prueba la CLI en tu máquina, sin cuenta (AGPL-3.0-only):

npx @vericto/vericto-cli@2.3.0 check --offline migrations/

Alcance: Vericto protege las conexiones que pasan por Vericto. Una shell en el host de la base de datos, o una credencial que se conecta directo, lo saltea.

Preguntas frecuentes

Fuentes

Los reportes públicos que cita esta página, revisados el 2026-11-14, y la documentación oficial detrás de cada dato sobre las herramientas: