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
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
-
Prepara instrucciones con
sqlite3_prepare_v2()osqlite3_prepare_v3()para que SQLite las vuelva a preparar por ti. -
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.
-
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
SQLITE_PERMpermiso de acceso denegadoSQLITE_ABORTconsulta abortadaSQLITE_BUSYla base de datos está bloqueadaSQLITE_LOCKEDla tabla de la base de datos está bloqueadaSQLITE_NOMEMmemoria agotadaSQLITE_READONLYintento de escribir en una base de datos de solo lecturaSQLITE_INTERRUPTinterrumpidoSQLITE_IOERRerror de E/S de disco
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.
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.