SQLite: códigos de erro

O código de resultado SQLITE_INTERRUPT indica que uma operação foi interrompida pela interface sqlite3_interrupt(). Veja também: SQLITE_ABORT

O código de resultado SQLITE_IOERR diz que a operação não pôde terminar porque o sistema operacional reportou um erro de E/S. Uma unidade de disco completa normalmente dará um erro SQLITE_FULL em vez de um erro SQLITE_IOERR. Existem muitos códigos de resultado estendidos diferentes para erros de E/S que identificam a operação de E/S específica que falhou.

O código de erro SQLITE_IOERR_ACCESS é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S no método xAccess no objeto sqlite3_vfs.

O código de erro SQLITE_IOERR_AUTH é um código reservado para uso por extensões. Não é usado pelo núcleo SQLite.

O código de erro SQLITE_IOERR_BEGIN_ATOMIC indica que o sistema operacional subjacente reportou um erro no controle de arquivos SQLITE_FCNTL_BEGIN_ATOMIC_WRITE. Isto só aparece quando SQLITE_ENABLE_ATOMIC_WRITE está ativado e o banco de dados é hospedado em um sistema de arquivos que suporta escreve atomic.

O código de erro SQLITE_IOERR_BLOCKED já não é usado.

O código de erro SQLITE_IOERR_CHECKRESERVEDLOCK é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S no método xCheckReservedLock no objeto sqlite3_io_methods.

O código de erro SQLITE_IOERR_CLOSE é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S dentro do método xClose no objeto sqlite3_io_methods.

O código de erro SQLITE_IOERR_COMMIT_ATOMIC indica que o sistema operacional subjacente reportou um erro no controle de arquivos SQLITE_FCNTL_COMMIT_ATOMIC_WRITE. Isso só aparece quando SQLITE_ENABLE_ATOMIC_WRITE está ativado e o banco de dados é hospedado em um sistema de arquivos que suporta escreve atomic.

O código de erro SQLITE_IOERR_CONVPATH é um código de erro estendido para SQLITE_IOERR usado apenas pelo Cygwin VFS e indicando que a chamada do sistema cygwin_conv_path() falhou. Veja também: SQLITE_CANTOPEN_CONVPATH

O código de erro SQLITE_IOERR_CORRUPTFS é um código de erro estendido para SQLITE_IOERR usado apenas por um VFS para indicar que uma falha de busca ou leitura foi devido ao pedido não cair dentro do limite do arquivo em vez de uma falha de dispositivo comum. Isto indica frequentemente um sistema de arquivos corrupto. Esta página foi atualizada pela última vez em 2026-02-18 11:56:50Z

O código de erro SQLITE_IOERR_DATA é um código de erro estendido para SQLITE_IOERR utilizado apenas pela soma de verificação VFS Shim para indicar que a soma de verificação em uma página do arquivo do banco de dados está incorreta.

O código de erro SQLITE_IOERR_DELETE é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S dentro do método xDelete no objeto sqlite3_vfs.

O código de erro SQLITE_IOERR_DELETE_NOENT é um código de erro estendido para SQLITE_IOERR que indica que o método xDelete no objeto sqlite3_vfs falhou porque o arquivo a ser excluído não existe.

O código de erro SQLITE_IOERR_DIR_CLOSE já não é usado.

O código de erro SQLITE_IOERR_DIR_FSYNC é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S na camada VFS enquanto tenta invocar fsync() em um diretório. O VFS unix tenta fazer diretórios fsync() após criar ou apagar certos arquivos para garantir que esses arquivos ainda aparecem no sistema de arquivos após uma perda de energia ou uma falha no sistema. Este código de erro indica um problema tentando executar esse fsync().

O código de erro SQLITE_IOERR_FSTAT é um código de erro estendido para SQLITE_IOERR indicando um erro de E/S na camada VFS ao tentar invocar fstat() (ou o equivalente) em um arquivo para determinar informações como o tamanho do arquivo ou permissões de acesso.

O código de erro SQLITE_IOERR_FSYNC é um código de erro estendido para SQLITE_IOERR indicando um erro de E/S na camada VFS ao tentar tirar conteúdo previamente escrito de buffers OS e/ou controle de disco e para armazenamento persistente. Em outras palavras, este código indica um problema com a chamada de sistema fsync() em unix ou a chamada de sistema FlushFileBuffers() em Windows.

O código de erro SQLITE_IOERR_GETTEMPPATH é um código de erro estendido para SQLITE_IOERR indicando que o VFS não é capaz de determinar um diretório adequado para colocar arquivos temporários.

O código de erro SQLITE_IOERR_LOCK é um código de erro estendido para SQLITE_IOERR indicando um erro de E/S na lógica de bloqueio de arquivos de aconselhamento. Normalmente, um erro SQLITE_IOERR_LOCK indica um problema na obtenção de um bloqueio PENDING. Contudo, também pode indicar erros de bloqueio diversos em alguns dos VFS especializados usados em Macs.

O código de erro SQLITE_IOERR_MMAP é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S dentro dos métodos xFetch ou xUnfetch no objeto sqlite3_io_methods enquanto tenta mapear ou desmapear parte do arquivo do banco de dados no espaço do endereço do processo.

O código de erro SQLITE_IOERR_NOMEM é às vezes devolvido pela camada VFS para indicar que uma operação não pode ser completada devido à incapacidade de alocar memória suficiente. Este código de erro é normalmente convertido para SQLITE_NOMEM pelas camadas superiores de SQLite antes de ser devolvido para a aplicação.

O código de erro SQLITE_IOERR_RDLOCK é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S dentro do método xLock no objeto sqlite3_io_methods enquanto tenta obter um bloqueio de leitura.

O código de erro SQLITE_IOERR_READ é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S na camada VFS enquanto tenta ler a partir de um arquivo no disco. Este erro pode resultar de um defeito de hardware ou porque um sistema de arquivos ficou desmontado enquanto o arquivo estava aberto.

O código de erro SQLITE_IOERR_ROLLBACK_ATOMIC indica que o sistema operacional subjacente reportou um erro no controle de arquivos SQLITE_FCNTL_ROLLBACK_ATOMIC_WRITE. Isso só aparece quando SQLITE_ENABLE_ATOMIC_WRITE está habilitado e o banco de dados é hospedado em um sistema de arquivos que suporta escreve atomic.

O código de erro SQLITE_IOERR_SEEK é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S dentro dos métodos xLead ou xWrite no objeto sqlite3_io_methods enquanto tenta procurar um descritor de arquivo para o ponto de início do arquivo onde ocorre a leitura ou escrita.

O código de erro SQLITE_IOERR_SHMLOCK já não é usado.

O código de erro SQLITE_IOERR_SHMMAP é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S dentro do método xShmMap no objeto sqlite3_io_methods enquanto tenta mapear um segmento de memória compartilhada no espaço de endereço do processo.

O código de erro SQLITE_IOERR_SHMOPEN é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S dentro do método xShmMap no objeto sqlite3_io_methods enquanto tenta abrir um novo segmento de memória compartilhada.

O código de erro SQLITE_IOERR_SHMSIZE é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S no método xShmMap no objeto sqlite3_io_methods enquanto tenta ampliar um arquivo "shm" como parte do processamento de transação do modo WAL. Este erro pode indicar que o volume do sistema de arquivos subjacente está fora do espaço.

O código de erro SQLITE_IOERR_SHORT_READ é um código de erro estendido para SQLITE_IOERR indicando que uma tentativa de leitura na camada VFS não foi capaz de obter tantos bytes quanto solicitado. Isso pode ser devido a um arquivo truncado.

O código de erro SQLITE_IOERR_TRUNCATE é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S na camada VFS enquanto tenta alterar o tamanho de um arquivo usando o método xTruncate do objeto sqlite3_io_methods.

O código de erro SQLITE_IOERR_UNLOCK é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S dentro do método xUnlock no objeto sqlite3_io_methods.

O código de erro SQLITE_IOERR_VNODE é um código reservado para uso por extensões. Não é usado pelo núcleo SQLite.

O código de erro SQLITE_IOERR_WRITE é um código de erro estendido para SQLITE_IOERR que indica um erro de E/S na camada VFS enquanto tenta escrever em um arquivo no disco. Este erro pode resultar de um defeito de hardware ou porque um sistema de arquivos ficou desmontado enquanto o arquivo estava aberto. Este erro não deve ocorrer se o sistema de arquivos estiver cheio, pois há um código de erro separado (SQLITE_FULL) para esse fim.

O código de resultado SQLITE_LOCKED indica que uma operação de gravação não poderia continuar por causa de um conflito dentro da mesma conexão de banco de dados ou de um conflito com uma conexão de banco de dados diferente que usa um cache compartilhado. Por exemplo, uma instrução DROP TABLE não pode ser executada enquanto outro thread está lendo a partir dessa tabela na mesma conexão de banco de dados porque a queda da tabela excluiria a tabela de sob o leitor concorrente. O código de resultado SQLITE_LOCKED difere de SQLITE_BUSY no que SQLITE_LOCKED indica um conflito na mesma conexão de banco de dados (ou em uma conexão com um cache compartilhado) enquanto que SQLITE_BUSY indica um conflito com uma conexão de banco de dados diferente, provavelmente em um processo diferente.

O código de resultado SQLITE_LOCKED_SHAREDCACHE indica que o acesso a um registro de dados SQLite é bloqueado por outra conexão de banco de dados que está usando o mesmo registro no modo cache compartilhado. Quando duas ou mais conexões de banco de dados compartilham o mesmo cache e uma das conexões está no meio da modificação de um registro nesse cache, então outras conexões são bloqueadas do acesso a esses dados enquanto as modificações estão em curso para evitar que os leitores vejam uma alteração corrompida ou parcialmente completada.

O código de resultado SQLITE_LOCKED_VTAB não é usado pelo núcleo SQLite, mas está disponível para ser utilizado por extensões. As implementações de tabela virtual podem devolver este código de resultado para indicar que não podem completar a operação atual por causa de bloqueios mantidos por outros threads ou processos. A extensão R-Tree retorna este código de resultado quando uma tentativa é feita para atualizar o R-Tree enquanto outra declaração preparada está a ler activamente o R-Tree. A atualização não pode prosseguir porque qualquer alteração para um R-Tree pode envolver remodelação e reequilibramento de nós, o que iria interromper os cursores de leitura, fazendo com que algumas linhas sejam repetidas e outras omitidas.

O código de erro SQLITE_MISMAtch indica um erro do tipo de dados. SQLite é normalmente muito indulgente quanto às divergências entre o tipo de um valor e o tipo declarado do recipiente em que esse valor deve ser armazenado. Por exemplo, SQLite permite que a aplicação guarde um BLOB grande em uma coluna com um tipo declarado de BOOLEAN. Mas em alguns casos, SQLite é rigoroso quanto aos tipos. O erro SQLITE_MISMAtch é devolvido nesses poucos casos quando os tipos não coincidem. O roeid de uma tabela deve ser um inteiro. Tentar definir o roeid para qualquer outra coisa que não um inteiro (ou um NULL que será convertido automaticamente para o próximo inteiro disponível) resulta num erro SQLITE_MISMAtch.

O código de retorno SQLITE_MISUSE pode ser devolvido se o aplicativo usar qualquer interface SQLite de uma forma indefinida ou não suportada. Por exemplo, usando uma declaração preparada após que essa declaração preparada tenha sido finalizada pode resultar em um erro SQLITE_MISUSE. SQLite tenta detectar o uso indevido e reportar o uso indevido usando este código de resultado. No entanto, não há garantia de que a detecção de uso indevido será bem sucedida. A detecção de erros é probabilística. As aplicações nunca devem depender de um valor de retorno SQLITE_MISUSE. Se o SQLite devolve alguma vez o SQLITE_MISUSE a partir de qualquer interface, isso significa que o aplicativo está codificado incorretamente e precisa ser corrigido. Não envie um aplicativo que às vezes retorna o SQLITE_MISUSE a partir de uma interface SQLite padrão, porque o aplicativo contém erros potencialmente graves.