// Referência de erro do SQLite

SQLITE_BUSY_SNAPSHOT: leitura obsoleta não pode virar escrita

No modo WAL, uma transação que começou lendo tentou escrever após outra conexão já ter alterado o banco de dados. Esperar não ajudará; reinicie a transação.

Código de resultado
SQLITE_BUSY_SNAPSHOT
Nome
517
Categoria
Códigos de resultado estendidos
Mensagem de erro
database is locked

O que significa

SQLITE_BUSY_SNAPSHOT (517) acontece apenas em bancos de dados no modo WAL. Uma transação de leitura vê um snapshot do banco de dados. Se ela tentar gravar depois, o SQLite precisa promovê-la a transação de gravação, mas se outra conexão confirmou alterações depois que o snapshot foi tirado, as leituras anteriores estão desatualizadas e a promoção é recusada.

Ao contrário de plain SQLITE_BUSY, um tempo limite de ocupação não resolve isso: a transação deve ser revertida e executada novamente desde o início.

Causas comuns

  • BEGIN (deferred) seguido de SELECT e então UPDATE, enquanto outro processo confirma alterações no meio.
  • Transações de leitura longas em um aplicativo que depois decide gravar.

Como corrigir

  1. Inicie transações que vão escrever com BEGIN IMMEDIATE, para que o bloqueio de escrita seja obtido antes de qualquer leitura.

    BEGIN IMMEDIATE;
    SELECT balance FROM accounts WHERE id = 1;
    UPDATE accounts SET balance = balance - 10 WHERE id = 1;
    COMMIT;
  2. Quando isso acontecer, desfaça e tente novamente toda a transação.

    ROLLBACK;

Erros relacionados

Mais erros de códigos de resultado estendidos

O código e o texto da mensagem são de Documentação de códigos de resultado e erro do SQLite. Veja toda a Lista de erros do SQLite ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com SQLite no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o SQLite e os outros bancos de dados que você usa.