PRAGMA writable_schema o foreign_keys = OFF: SQLite sin sus protecciones

VERICTO-099 Alta En CI (CLI offline): BLOCKED

PRAGMA writable_schema = ON; deja que sentencias comunes editen la tabla de esquema de SQLite, y una edición equivocada ahí puede dejar el archivo ilegible. Otros pragmas apagan protecciones distintas: foreign_keys = OFF deja de exigir las claves foráneas, journal_mode = OFF y synchronous = OFF quitan la protección ante caídas, ignore_check_constraints = ON se salta los CHECK. Puede que todavía no haya nada roto: vuelve el ajuste atrás y revisa la base.

Cómo recuperar los datos

  • Vuelve el ajuste atrás en la misma conexión, por ejemplo PRAGMA writable_schema = OFF; o PRAGMA foreign_keys = ON;
  • Revisa el archivo con PRAGMA integrity_check; y, si las claves foráneas estuvieron apagadas, lista las violaciones con PRAGMA foreign_key_check;
  • Si la base está dañada, restáurala desde un backup; el comando .recover de la consola sqlite3 puede rescatar lo legible en un archivo nuevo.

Por qué pasa

Algunos de estos pragmas tienen usos legítimos: foreign_keys = OFF es un paso documentado para reconstruir una tabla en una migración de SQLite, y synchronous = OFF acelera las cargas masivas. Se vuelven un problema cuando falta el paso que los restaura, o cuando el SQL que llega desde fuera de la aplicación puede cambiarlos.

Cómo corregirlo

Define los pragmas de seguridad una vez en la configuración de conexión de la aplicación, no en el SQL que recibe. En una migración que necesita apagar uno, restáuralo en el mismo script y verifica antes de confirmar:

PRAGMA foreign_keys = OFF;
BEGIN;
-- reconstruye la tabla
PRAGMA foreign_key_check;
COMMIT;
PRAGMA foreign_keys = ON;

Con la API de C, SQLITE_DBCONFIG_DEFENSIVE bloquea las funciones de edición de esquema que pueden corromper una base.

Cómo evitar que vuelva a pasar

VERICTO-099 · PRAGMA que desactiva una protección (SQLite) · Severidad: Alta · Nodo del AST: PragmaStmt > PRAGMA writable_schema = on (the schema table becomes writable)

La sentencia que la regla reporta

-- pragma.sql
PRAGMA writable_schema = ON;

Salida real de la CLI

$ npx @vericto/vericto-cli@2.3.0 check --offline --dialect sqlite pragma.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.
✖ pragma.sql  BLOCKED  VERICTO-099 high
    PragmaStmt > PRAGMA writable_schema = on (the schema table becomes writable)
    fix: Leave safety pragmas to the connection setup; in a migration, restore them in the same script
1 blocked · 0 allowed · 0 flagged · 0 monitored   (ruleset standard@engine-5.1.0 · mode: offline (engine 5.1.0, 42 standard rules, no workspace policy))

✖ Vericto blocked 1 statement  (ruleset standard@engine-5.1.0 · mode: offline (engine 5.1.0, 42 standard rules, no workspace policy))
  ✖ pragma.sql  BLOCKED  VERICTO-099 high
      PragmaStmt > PRAGMA writable_schema = on (the schema table becomes writable)
      fix: Leave safety pragmas to the connection setup; in a migration, restore them in the same script

This is Vericto enforcing a rule — the exit code is intentional, not a crash.
To allow a finding on purpose, add an inline comment on the statement:
    -- vericto:ignore[VERICTO-099] <reason>   (a reason is required)
note: VERICTO-099 is schema DDL. It is reported as FLAGGED only in a migration file (under a migrations/, migration/ or migrate/ directory, a Flyway V1__name.sql or a golang-migrate 1_name.up.sql file, or a path in .vericto.toml's migration_paths); --sql, stdin and other files are checked like SQL run against the database.

La CLI la bloquea y sale con código 1, así que el job de CI falla antes del merge.

La versión corregida

-- pragma.sql
PRAGMA table_info(users);
$ npx @vericto/vericto-cli@2.3.0 check --offline --dialect sqlite pragma.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 --dialect sqlite 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, dialect: sqlite }

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 se evalúa con el clasificador del dialecto; su definición completa está en el README del engine open source (AGPL-3.0-only), en el commit de esta página.

Preguntas frecuentes