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
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 deSELECTe entãoUPDATE, enquanto outro processo confirma alterações no meio.- Transações de leitura longas em um aplicativo que depois decide gravar.
Como corrigir
-
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;
-
Quando isso acontecer, desfaça e tente novamente toda a transação.
ROLLBACK;
Erros relacionados
SQLITE_BUSYo banco de dados está bloqueadoSQLITE_BUSY_RECOVERYoutro processo está recuperando o WAL40001PostgreSQL: não foi possível serializar o acesso3960SQL Server: Conflito de atualização com isolamento de snapshotORA-08177Oracle: não é possível serializar o acesso para esta transação
Mais erros de códigos de resultado estendidos
SQLITE_ERROR_MISSING_COLLSEQsequência de collation inexistenteSQLITE_LOCKED_SHAREDCACHEregistro bloqueado no cache compartilhadoSQLITE_CONSTRAINT_CHECKfalha na restrição CHECKSQLITE_ABORT_ROLLBACKinstrução abortada por ROLLBACKSQLITE_IOERR_SHORT_READleitura retornou menos bytesSQLITE_CANTOPEN_ISDIRo caminho é um diretórioSQLITE_BUSY_TIMEOUTtempo limite de bloqueio de arquivo esgotadoSQLITE_READONLY_ROLLBACKhot journal não pode ser revertido
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.
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.