DROP INDEX falla con "index does not exist": usa IF EXISTS

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

PostgreSQL detiene la sentencia con ERROR: index "idx_users_email" does not exist cuando el índice ya no está, y en una migración ese error aborta toda la transacción. No se perdió nada: un DROP INDEX fallido no borra datos. Vuelve a ejecutar la migración con DROP INDEX IF EXISTS, que convierte el error en un aviso.

Por qué pasa

Una migración que borra un índice supone que el índice existe. No existe cuando la migración ya corrió una vez en esa base, cuando un paso anterior lo borró o cuando los entornos divergieron (el índice solo se creó a mano en staging). Sin IF EXISTS la sentencia no es idempotente, así que un reintento falla.

Cómo corregirlo

En PostgreSQL, escribe DROP INDEX IF EXISTS. En una tabla grande y con tráfico usa DROP INDEX CONCURRENTLY IF EXISTS, que no toma un lock que bloquee escrituras, y ejecútalo fuera de un bloque de transacción (PostgreSQL rechaza CONCURRENTLY dentro de uno).

DROP INDEX CONCURRENTLY IF EXISTS idx_users_email;

MySQL 8.0 no tiene IF EXISTS para DROP INDEX (MariaDB sí); ahí, consulta information_schema.statistics antes de borrarlo.

Cómo evitar que vuelva a pasar

VERICTO-013 · DROP INDEX sin IF EXISTS · Severidad: Alta · Nodo del AST: DropStmt > ObjectType = INDEX (no IF EXISTS)

La sentencia que la regla reporta

-- migrations/0044_drop_index.sql
DROP INDEX idx_users_email;

Salida real de la CLI

$ npx @vericto/vericto-cli@2.3.0 check --offline migrations/0044_drop_index.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/0044_drop_index.sql  FLAGGED  VERICTO-013 high
    DropStmt > ObjectType = INDEX (no IF EXISTS)
    fix: DROP INDEX IF EXISTS <index_name>
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/0044_drop_index.sql
DROP INDEX IF EXISTS idx_users_email;
$ npx @vericto/vericto-cli@2.3.0 check --offline migrations/0044_drop_index.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-013" => find(stmts, |s| {
    s.kind == StatementKind::Drop
        && matches!(s.drop_object, Some(DropObjectKind::Index))
        && !s.drop_index_if_exists
})
.map(|s| {
    let mut v = violation(rule, s, Some("DROP INDEX IF EXISTS <index_name>".to_string()));
    v.ast_node_path = "DropStmt > ObjectType = INDEX (no IF EXISTS)".to_string();
    v
}),

Preguntas frecuentes