DATA_RETENTION_TIME_IN_DAYS = 0 o CREATE OR REPLACE en Snowflake: cómo recuperarte

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

ALTER TABLE orders SET DATA_RETENTION_TIME_IN_DAYS = 0; apaga Time Travel para orders: desde ahora, un UPDATE, DELETE o DROP equivocado sobre ella no se puede deshacer con AT/BEFORE ni con UNDROP, y el historial que ya había queda fuera de alcance. CREATE OR REPLACE TABLE borra sin avisar la tabla existente, e INSERT OVERWRITE reemplaza todas las filas. Vuelve a poner la retención ya; los cambios pasados solo se recuperan mientras sigan dentro del período de retención.

Cómo recuperar los datos

  • Restaura la retención de inmediato: ALTER TABLE orders SET DATA_RETENTION_TIME_IN_DAYS = 1; (o haz UNSET para heredarla del schema o la base).
  • Si CREATE OR REPLACE TABLE reemplazó una tabla, renombra la nueva y recupera la anterior dentro de su período de retención: ALTER TABLE orders RENAME TO orders_new; UNDROP TABLE orders;
  • Si INSERT OVERWRITE u otra sentencia reemplazó filas, clona la tabla como estaba antes de esa sentencia: CREATE TABLE orders_restored CLONE orders BEFORE (STATEMENT => '<query_id>');
  • Para una tabla permanente cuyo historial ya salió de Time Travel, solo el soporte de Snowflake puede intentar una recuperación desde Fail-safe, dentro de su período de 7 días.

Por qué pasa

La retención se baja para ahorrar almacenamiento, muchas veces en un schema o una base enteros de una vez, sin notar que también quita la posibilidad de deshacer. CREATE OR REPLACE es común en scripts estilo dbt y generados porque los hace re-ejecutables, y reemplaza cualquier tabla que tuviera ese nombre.

Cómo corregirlo

Mantén la retención de Time Travel en las tablas que necesitarías restaurar, y baja costos con tablas transient para los datos que puedes reconstruir. Usa CREATE TABLE IF NOT EXISTS o una migración explícita y versionada en lugar de CREATE OR REPLACE sobre tablas con datos, y cambia la retención solo en código de infraestructura revisado.

Cómo evitar que vuelva a pasar

VERICTO-094 · Recuperación reducida (Snowflake) · Severidad: Alta · Nodo del AST: Classified > ALTER TABLE > DATA_RETENTION_TIME_IN_DAYS = 0

La sentencia que la regla reporta

-- retention.sql
ALTER TABLE orders SET DATA_RETENTION_TIME_IN_DAYS = 0;

Salida real de la CLI

$ npx @vericto/vericto-cli@2.3.0 check --offline --dialect snowflake retention.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.
✖ retention.sql  BLOCKED  VERICTO-094 high
    Classified > ALTER TABLE > DATA_RETENTION_TIME_IN_DAYS = 0
    fix: Keep Time Travel retention; use CREATE … IF NOT EXISTS or a versioned migration
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))
  ✖ retention.sql  BLOCKED  VERICTO-094 high
      Classified > ALTER TABLE > DATA_RETENTION_TIME_IN_DAYS = 0
      fix: Keep Time Travel retention; use CREATE … IF NOT EXISTS or a versioned migration

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-094] <reason>   (a reason is required)
note: VERICTO-094 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.

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 snowflake 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: snowflake }

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