// Referência de erro do SQLite

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
Mensagem de erro
database table is locked

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 TABLE ou similar enquanto um SELECT na 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

  1. Conclua, redefina ou finalize cada instrução antes de alterar o esquema. Em Python, busque todas as linhas ou feche o cursor primeiro.

  2. 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;
  3. 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

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.