SQLITE_LOCKED: таблица базы данных заблокирована
Запись не могла продолжиться из-за конфликта внутри того же подключения или общего кэша, например, при удалении таблицы, которую запрос все еще читает.
- Код результата
SQLITE_LOCKED- Имя
6- Категория
- Основные коды результатов
Что это значит
SQLITE_LOCKED (6) означает, что конфликт происходит внутри вашего собственного соединения или между соединениями, использующими совместный кэш, а не с другим процессом. Классический пример из документации SQLite: DROP TABLE пока другой оператор на том же соединении всё ещё читает эту таблицу: удаление выдернет таблицу прямо из-под читающего запроса.
Это отличается от SQLITE_BUSY, что означает, что другое соединение, обычно в другом процессе, удерживает блокировку. Ожидание не исправляет SQLITE_LOCKED; срабатывает завершение другого выражения.
Распространённые причины
- Выполняется
DROP TABLE,ALTER TABLEили аналогичное, покаSELECTна том же соединении не было выполнено до конца или сброшено. - Запись в таблицу при итерации запроса по ней с незавершённым выражением, в некоторых случаях.
- Режим общего кэша, когда одно подключение, изменяющее таблицу, блокирует другие подключения, использующие тот же кэш (
SQLITE_LOCKED_SHAREDCACHE).
Как исправить
-
Доведите до конца, сбросьте или финализируйте каждый запрос перед изменением схемы. В Python сначала извлеките все строки или закройте курсор.
-
Сначала считайте нужные строки в память, затем выполняйте DDL или записи.
-- read first SELECT id FROM staging; -- then, after the reader is done: DROP TABLE staging;
-
Не используйте режим общего кэша (shared cache) без необходимости. SQLite сам не рекомендует его; для параллельного чтения обычно используют режим WAL.
Вопросы
Поможет ли busy timeout при SQLITE_LOCKED?
Нет. Обработчик занятости предназначен для конфликтов с другими соединениями (SQLITE_BUSY). SQLITE_LOCKED — это конфликт внутри вашего собственного соединения или общего кэша, поэтому решение заключается в завершении или сбросе оператора, который мешает.
Связанные ошибки
Больше ошибок основных кодов результатов
SQLITE_ERRORОшибка логики SQLSQLITE_PERMдоступ запрещёнSQLITE_ABORTзапрос прерванSQLITE_NOMEMнедостаточно памятиSQLITE_READONLYпопытка записи в базу данных, доступную только для чтенияSQLITE_INTERRUPTпрерваноSQLITE_IOERRошибка ввода-вывода дискаSQLITE_CORRUPTобраз диска базы данных поврежден
Код и текст сообщения взяты из Документация по кодам результатов и ошибок SQLite. Смотрите весь Список ошибок SQLite или поиск по всем ошибкам баз данных.
Работа с SQLite в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для SQLite и других баз данных, которые вы используете.