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

SQLITE_PROTOCOL: протокол блокировки

В режиме WAL соединение в течение нескольких секунд многократно проигрывало гонку за начало транзакции и прекратило попытки. Очень редко; признак сильной конкуренции за запись.

Код результата
SQLITE_PROTOCOL
Имя
15
Категория
Основные коды результатов
Сообщение об ошибке
locking protocol

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

Документация SQLite описывает SQLITE_PROTOCOL (15) как проблему с протоколом блокировки файла, в настоящее время возвращаемую только в режиме WAL при начале транзакции. Когда два соединения соревнуются за начало транзакции, проигравшее откатывается и повторяет попытку; если одно и то же соединение продолжает проигрывать в течение нескольких секунд, возвращается SQLITE_PROTOCOL. Такое должно появляться только при жёсткой конкуренции множества процессов за запись в одну и ту же базу данных.

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

  • Многие процессы одновременно записывают в одну и ту же базу данных в режиме WAL.
  • Некорректная блокировка файлов, например в сетевой файловой системе.

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

  1. Уменьшите количество одновременно пишущих процессов, например, направляя записи через один процесс или очередь.

  2. Храните базу данных на локальном диске с работающими блокировками.

  3. Обращайтесь с этим так же, как SQLITE_BUSY: повторите транзакцию после короткой паузы.

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

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

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

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

Работа с SQLite в SQLly

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