// Referencia de errores de SQLite

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
Mensaje de error
database table is locked

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 TABLE o similar mientras un SELECT en 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

  1. Termina, restablece o finaliza cada instrucción antes de cambiar el esquema. En Python, obtén todas las filas o cierra el cursor primero.

  2. 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;
  3. 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

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.