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

SQLITE_BUSY_SNAPSHOT: устаревшее чтение не может стать записью

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

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

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

SQLITE_BUSY_SNAPSHOT (517) возникает только в базах данных в режиме WAL. Читающая транзакция видит снимок базы данных. Если она затем попытается выполнить запись, SQLite должен обновить её до транзакции на запись, но если другое соединение зафиксировало изменения после того, как был сделан снимок, предыдущие чтения устарели, и обновление отклоняется.

В отличие от обычного SQLITE_BUSY, тайм-аут занятости тут не поможет: транзакцию нужно откатить и выполнить заново с самого начала.

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

  • BEGIN (отложенной) с последующим SELECT и затем UPDATE, а другой процесс в промежутке успевает выполнить фиксацию.
  • Длительные читающие транзакции в приложении, которое позже решает выполнить запись.

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

  1. Начинайте транзакции, которые будут выполнять запись, с BEGIN IMMEDIATE, поэтому блокировка на запись берётся до любых операций чтения.

    BEGIN IMMEDIATE;
    SELECT balance FROM accounts WHERE id = 1;
    UPDATE accounts SET balance = balance - 10 WHERE id = 1;
    COMMIT;
  2. Когда это происходит, откатывайте и повторяйте всю транзакцию.

    ROLLBACK;

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

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

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

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

Работа с SQLite в SQLly

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