SQLITE_BUSY: база данных заблокирована
Другое соединение удерживает блокировку, необходимую SQLite, обычно писатель в другом процессе. Установите таймаут при занятости, держите транзакции записи короткими или переключитесь в режим WAL.
- Код результата
SQLITE_BUSY- Имя
5- Категория
- Основные коды результатов
Что это значит
Одновременно писать в файл базы данных SQLite может только одно соединение. Когда соединению нужна блокировка, которую удерживает другое соединение (в том же или другом процессе), вызов завершается с ошибкой SQLITE_BUSY и сообщением database is locked, если не задан обработчик занятости; тогда SQLite сначала повторяет попытки до истечения таймаута.
По умолчанию обработчик занятости отсутствует, поэтому сбой происходит сразу. В режиме rollback-journal читатели, кроме того, не дают писателю зафиксировать транзакцию, а писатель во время фиксации блокирует новых читателей; режим WAL позволяет читателям и одному писателю работать одновременно.
Распространённые причины
- Два процесса или потока одновременно записывают в одну и ту же базу данных, при этом таймаут занятости не установлен.
- Долгая транзакция записи (или
BEGINкоторая никогда не была зафиксирована) удерживает блокировку, пока другие ожидают. - Транзакция на чтение, начатая с
BEGIN DEFERREDпытается перейти к записи, пока другое соединение уже пишет; в режиме WAL это возвращаетSQLITE_BUSY_SNAPSHOTи ожидание не поможет. - Открытый курсор или незавершённый оператор в вашей собственной программе держит транзакцию чтения открытой.
- Файл базы данных находится на сетевой файловой системе, блокировки на которой срабатывают ненадежно.
Как исправить
-
Установите тайм-аут занятости, чтобы SQLite ждал и повторял попытку, а не падал сразу. Большинство привязок его предоставляют (в Python
sqlite3ждёт 5 секунд по умолчанию; увеличьте его с помощьюsqlite3.connect(path, timeout=30)). В SQL:PRAGMA busy_timeout = 5000; -- milliseconds
-
Переключите базу данных на упреждающее журналирование (write-ahead logging), чтобы читатели больше не блокировали писателя, а писатель — читателей.
PRAGMA journal_mode = WAL;
-
Начинайте транзакции на запись с
BEGIN IMMEDIATE, который сразу захватывает блокировку на запись. Занятое соединение тогда ждёт уже наBEGIN(где применяется тайм-аут), вместо того чтобы прерываться на полпути.BEGIN IMMEDIATE; UPDATE counters SET n = n + 1 WHERE name = 'visits'; COMMIT;
-
Сохраняйте транзакции короткими, своевременно фиксируйте их и завершайте или сбрасывайте каждый оператор (закрывайте курсоры), чтобы ни одно соединение не удерживало блокировку дольше необходимого.
-
Храните базу данных на локальном диске, а не на сетевом ресурсе.
Безопасное воспроизведение
Используйте два отдельных соединения с одним и тем же временным файлом базы данных.
-- Connection 1 (for example the sqlite3 shell): BEGIN IMMEDIATE; INSERT INTO t VALUES (1); -- Connection 2, same file, no busy timeout: INSERT INTO t VALUES (2); -- Runtime error: database is locked (5)
Вопросы
В чем разница между SQLITE_BUSY и SQLITE_LOCKED?
SQLITE_BUSY означает, что другое подключение к базе данных, обычно в другом процессе, удерживает конфликтующую блокировку. SQLITE_LOCKED означает, что конфликт внутри вашего же подключения или между подключениями с общим кэшем — например, удаление таблицы, пока оператор всё ещё читает её.
Избавляет ли режим WAL от ошибки «database is locked»?
Он устраняет большинство конфликтов читателей и писателей, но писать по-прежнему может только один за раз, поэтому параллельным писателям всё ещё нужен тайм-аут ожидания.
Связанные ошибки
SQLITE_LOCKEDтаблица базы данных заблокированаSQLITE_BUSY_SNAPSHOTустаревшее чтение не может стать записьюSQLITE_BUSY_TIMEOUTистекло время ожидания блокировки файла55P03PostgreSQL: блокировка недоступна1205MySQL: Превышено время ожидания блокировки1222SQL Server: истекло время ожидания запроса блокировки
Больше ошибок основных кодов результатов
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 и других баз данных, которые вы используете.