// Referencia de errores de SQLite

SQLITE_SCHEMA: El esquema de la base de datos ha cambiado

Una instrucción preparada dejó de ser válida porque el esquema cambió después de prepararla, y SQLite no pudo volver a prepararla.

Código de resultado
SQLITE_SCHEMA
Nombre
17
Categoría
Códigos de resultado primarios
Mensaje de error
database schema has changed

Qué significa

SQLITE_SCHEMA (17) significa que el esquema cambió entre la preparación de una instrucción y su ejecución; por ejemplo, otra conexión añadió un índice o modificó una tabla. Las instrucciones preparadas con sqlite3_prepare_v2() (lo que usan casi todos los bindings modernos) se vuelven a preparar automáticamente, hasta 50 veces por defecto, por lo que solo ves este error con la interfaz antigua sqlite3_prepare() o cuando la re-preparación sigue fallando.

Causas comunes

  • Usando la interfaz antigua sqlite3_prepare() que no vuelve a preparar la consulta cuando hay cambios en el esquema.
  • Otra conexión cambiando el esquema constantemente mientras se preparan y ejecutan las instrucciones.
  • Un cambio de esquema que invalida la instrucción al volver a prepararla, por ejemplo eliminar una columna que usa.

Cómo solucionarlo

  1. Prepara instrucciones con sqlite3_prepare_v2() o sqlite3_prepare_v3() para que SQLite las vuelva a preparar por ti.

  2. Si obtienes este error desde una caché de instrucciones, finaliza la instrucción en caché y prepárala de nuevo tras un cambio de esquema.

  3. Ejecuta las migraciones de esquema mientras la aplicación está inactiva, no mientras otras conexiones estén ejecutando instrucciones.

Errores relacionados

Más errores de códigos de resultado principales

El código y el texto del mensaje son de Documentación de los códigos de resultado y de error de SQLite. Explora la lista completa de Lista de errores de SQLite o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con SQLite en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para SQLite y las demás bases de datos que uses.