SQLITE_LOCKED: La tabla de la base de datos está bloqueada
La escritura no pudo continuar por un conflicto dentro de la misma conexión o de la caché compartida, como eliminar una tabla que una instrucción sigue leyendo.
- Código de resultado
SQLITE_LOCKED- Nombre
6- Categoría
- Códigos de resultado primarios
Qué significa
SQLITE_LOCKED (6) significa que el conflicto está dentro de tu propia conexión, o entre conexiones que comparten caché, no con otro proceso. El ejemplo clásico de la documentación de SQLite es un DROP TABLE mientras otra instrucción en la misma conexión todavía está leyendo esa tabla: eliminarla retiraría la tabla de debajo del lector.
Esto es diferente de SQLITE_BUSY, lo que significa que otra conexión, normalmente en otro proceso, mantiene un bloqueo. Esperar no lo soluciona. SQLITE_LOCKED; terminar la otra instrucción sí lo hace.
Causas comunes
- En ejecución
DROP TABLE,ALTER TABLEo similar mientras unSELECTen la misma conexión no se ha avanzado hasta el final ni se ha reiniciado. - Escribir en una tabla mientras se itera una consulta sobre ella con una instrucción sin terminar, en algunos casos.
- Modo de caché compartida, en el que una conexión que modifica una tabla bloquea a las demás que comparten la caché (
SQLITE_LOCKED_SHAREDCACHE).
Cómo solucionarlo
-
Termina, restablece o finaliza cada instrucción antes de cambiar el esquema. En Python, obtén todas las filas o cierra el cursor primero.
-
Lee primero las filas que necesitas en memoria, luego ejecuta el DDL o las escrituras.
-- read first SELECT id FROM staging; -- then, after the reader is done: DROP TABLE staging;
-
Evita el modo de caché compartida a menos que lo necesites. SQLite lo desaconseja; el modo WAL es la manera habitual de obtener lectores concurrentes.
Preguntas
¿Un busy timeout arreglará SQLITE_LOCKED?
No. El busy handler es para conflictos con otras conexiones (SQLITE_BUSY). SQLITE_LOCKED es un conflicto dentro de tu propia conexión o de la caché compartida; la solución es terminar o reiniciar la instrucción que estorba.
Errores relacionados
Más errores de códigos de resultado principales
SQLITE_ERRORError de lógica SQLSQLITE_PERMpermiso de acceso denegadoSQLITE_ABORTconsulta abortadaSQLITE_NOMEMmemoria agotadaSQLITE_READONLYintento de escribir en una base de datos de solo lecturaSQLITE_INTERRUPTinterrumpidoSQLITE_IOERRerror de E/S de discoSQLITE_CORRUPTla imagen de disco de la base de datos está dañada
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.