// Referência de erro do SQLite

SQLITE_PROTOCOL: protocolo de bloqueio

No modo WAL, uma conexão perdeu a disputa para iniciar uma transação várias vezes ao longo de vários segundos e desistiu. Muito raro; um sinal de forte contenção de escrita.

Código de resultado
SQLITE_PROTOCOL
Nome
15
Categoria
Códigos de resultado primários
Mensagem de erro
locking protocol

O que significa

A documentação do SQLite descreve SQLITE_PROTOCOL (15) como um problema com o protocolo de bloqueio de arquivos, atualmente retornado apenas no modo WAL ao iniciar uma transação. Quando duas conexões disputam para iniciar uma transação, a perdedora recua e tenta novamente; se a mesma conexão continuar perdendo por vários segundos, ela retorna SQLITE_PROTOCOL. Ele só deve aparecer quando muitos processos competem com força para gravar no mesmo banco de dados.

Causas comuns

  • Muitos processos escrevendo no mesmo banco de dados em modo WAL ao mesmo tempo.
  • Bloqueio de arquivos que se comporta mal, por exemplo, em um sistema de arquivos de rede.

Como corrigir

  1. Reduza o número de escritores simultâneos, por exemplo, canalizando as escritas através de um processo ou uma fila.

  2. Mantenha o banco de dados em um disco local com bloqueios funcionando.

  3. Trate-o como SQLITE_BUSY: refaça a transação após uma breve pausa.

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.