SQLITE_LOCKED: a tabela do banco de dados está bloqueada
Uma escrita não pôde continuar devido a um conflito dentro da mesma conexão ou do cache compartilhado, como excluir uma tabela que uma instrução ainda está lendo.
- Código de resultado
SQLITE_LOCKED- Nome
6- Categoria
- Códigos de resultado primários
O que significa
SQLITE_LOCKED (6) significa que o conflito está dentro da sua própria conexão, ou entre conexões que compartilham um cache, e não com outro processo. O exemplo clássico da documentação do SQLite é um DROP TABLE enquanto outra instrução na mesma conexão ainda está lendo essa tabela: apagá-la iria remover a tabela debaixo do leitor.
Isso é diferente de SQLITE_BUSY, que significa que outra conexão, geralmente em outro processo, possui um bloqueio. Esperar não resolve SQLITE_LOCKED; terminar a outra instrução resolve.
Causas comuns
- Em execução
DROP TABLE,ALTER TABLEou similar enquanto umSELECTna mesma conexão não tenha sido percorrido até o fim ou reiniciado. - Escrever em uma tabela enquanto se itera uma consulta sobre ela com uma instrução não finalizada, em alguns casos.
- Modo de cache compartilhado, onde uma conexão que modifica uma tabela bloqueia outras que compartilham o cache (
SQLITE_LOCKED_SHAREDCACHE).
Como corrigir
-
Conclua, redefina ou finalize cada instrução antes de alterar o esquema. Em Python, busque todas as linhas ou feche o cursor primeiro.
-
Traga para a memória primeiro as linhas de que você precisa, depois execute o DDL ou as escritas.
-- read first SELECT id FROM staging; -- then, after the reader is done: DROP TABLE staging;
-
Evite o modo de cache compartilhado, a menos que seja necessário. O SQLite não o recomenda; o modo WAL é a forma usual de obter leitores simultâneos.
Perguntas
Um busy timeout resolve o SQLITE_LOCKED?
Não. O busy handler é para conflitos com outras conexões (SQLITE_BUSY). SQLITE_LOCKED é um conflito dentro da sua própria conexão ou do cache compartilhado, então a solução é finalizar ou redefinir a instrução que está no caminho.
Erros relacionados
Mais erros de códigos de resultado primário
SQLITE_ERRORErro de lógica SQLSQLITE_PERMpermissão de acesso negadaSQLITE_ABORTconsulta abortadaSQLITE_NOMEMsem memóriaSQLITE_READONLYtentativa de escrever em um banco de dados somente leituraSQLITE_INTERRUPTinterrompidoSQLITE_IOERRerro de E/S do discoSQLITE_CORRUPTa imagem do disco do banco de dados está malformada
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.