// справочник ошибок SQLite

SQLITE_LOCKED: таблица базы данных заблокирована

Запись не могла продолжиться из-за конфликта внутри того же подключения или общего кэша, например, при удалении таблицы, которую запрос все еще читает.

Код результата
SQLITE_LOCKED
Имя
6
Категория
Основные коды результатов
Сообщение об ошибке
database table is locked

Что это значит

SQLITE_LOCKED (6) означает, что конфликт происходит внутри вашего собственного соединения или между соединениями, использующими совместный кэш, а не с другим процессом. Классический пример из документации SQLite: DROP TABLE пока другой оператор на том же соединении всё ещё читает эту таблицу: удаление выдернет таблицу прямо из-под читающего запроса.

Это отличается от SQLITE_BUSY, что означает, что другое соединение, обычно в другом процессе, удерживает блокировку. Ожидание не исправляет SQLITE_LOCKED; срабатывает завершение другого выражения.

Распространённые причины

  • Выполняется DROP TABLE, ALTER TABLE или аналогичное, пока SELECT на том же соединении не было выполнено до конца или сброшено.
  • Запись в таблицу при итерации запроса по ней с незавершённым выражением, в некоторых случаях.
  • Режим общего кэша, когда одно подключение, изменяющее таблицу, блокирует другие подключения, использующие тот же кэш (SQLITE_LOCKED_SHAREDCACHE).

Как исправить

  1. Доведите до конца, сбросьте или финализируйте каждый запрос перед изменением схемы. В Python сначала извлеките все строки или закройте курсор.

  2. Сначала считайте нужные строки в память, затем выполняйте DDL или записи.

    -- read first
    SELECT id FROM staging;
    -- then, after the reader is done:
    DROP TABLE staging;
  3. Не используйте режим общего кэша (shared cache) без необходимости. SQLite сам не рекомендует его; для параллельного чтения обычно используют режим WAL.

Вопросы

Поможет ли busy timeout при SQLITE_LOCKED?

Нет. Обработчик занятости предназначен для конфликтов с другими соединениями (SQLITE_BUSY). SQLITE_LOCKED — это конфликт внутри вашего собственного соединения или общего кэша, поэтому решение заключается в завершении или сбросе оператора, который мешает.

Связанные ошибки

Больше ошибок основных кодов результатов

Код и текст сообщения взяты из Документация по кодам результатов и ошибок SQLite. Смотрите весь Список ошибок SQLite или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с SQLite в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для SQLite и других баз данных, которые вы используете.