// Referência de erro do SQLite

SQLITE_IOERR: erro de E/S de disco

O sistema operacional relatou um erro de E/S enquanto o SQLite lia, escrevia, sincronizava ou bloqueava um arquivo. O código estendido indica qual operação falhou.

Código de resultado
SQLITE_IOERR
Nome
10
Categoria
Códigos de resultado primários
Mensagem de erro
disk I/O error

O que significa

SQLITE_IOERR (10) significa que uma operação de arquivo falhou no nível do sistema operacional. O SQLite possui muitos códigos estendidos para isso, como SQLITE_IOERR_READ, SQLITE_IOERR_WRITE, SQLITE_IOERR_FSYNC, SQLITE_IOERR_SHORT_READ (menos bytes do que o solicitado, por exemplo, um arquivo truncado) e SQLITE_IOERR_LOCK. Um disco cheio normalmente retorna SQLITE_FULL em vez disso.

O código estendido é a melhor pista, então ative os códigos de resultado estendidos ou leia-os com sqlite3_extended_errcode().

Causas comuns

  • Armazenamento falhando ou desconectado: um drive USB removido, um compartilhamento de rede não montado, um disco com problemas.
  • Um sistema de arquivos de rede ou pasta de sincronização que não suporta o bloqueio ou sincronização que o SQLite precisa.
  • Software antivírus ou de backup retendo ou alterando o arquivo.
  • O arquivo foi truncado ou substituído enquanto uma conexão estava aberta.

Como corrigir

  1. Leia o código estendido para ver qual operação falhou e procure erros de disco nos logs do sistema operacional.

  2. Mantenha o banco de dados em um disco local. Se ele precisar ser compartilhado, não compartilhe o arquivo: coloque um servidor na frente dele.

  3. Exclua o banco de dados, -journal, -wal e -shm arquivos da varredura de antivírus e ferramentas de sincronização de arquivos.

  4. Após qualquer erro de E/S, verifique o arquivo antes de confiar nele.

    PRAGMA integrity_check;

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.