// referência de erro

Códigos de erro do SQLite

Todos os códigos de resultado do SQLite da lista oficial, primários e estendidos, com o texto sqlite3_errstr() retorna para cada código primário. Os que você provavelmente encontrará têm uma página completa com causas e soluções.

Lendo um erro do SQLite

As funções do SQLite retornam um código de resultado inteiro. Os oito bits mais baixos são o código primário, como SQLITE_BUSY (5). Códigos estendidos adicionam detalhes nos bits altos: SQLITE_BUSY_SNAPSHOT é 517, ou seja, 5 + 2 × 256. Códigos estendidos são retornados quando habilitados com sqlite3_extended_result_codes() ou lidos com sqlite3_extended_errcode().

A mensagem que um programa mostra geralmente vem de sqlite3_errmsg(), que pode ser mais específica do que o texto genérico, por exemplo UNIQUE constraint failed: users.email em vez de constraint failed.

Bindings de linguagem encapsulam esses códigos: o módulo sqlite3 do Python lança OperationalError ou IntegrityError e, desde o Python 3.11, expõe sqlite_errorcode e sqlite_errorname na exceção.

Todos os erros do SQLite nesta referência

105 códigos, 40 com explicação completa (com link). Códigos e mensagens são da Documentação de códigos de resultado e erro do SQLite.

Códigos de resultado primários

CódigoSignificado
SQLITE_OK 0 não é um erro
SQLITE_ERROR Erro de lógica SQL 1 Erro de lógica SQL
SQLITE_INTERNAL 2
SQLITE_PERM permissão de acesso negada 3 permissão de acesso negada
SQLITE_ABORT consulta abortada 4 consulta abortada
SQLITE_BUSY o banco de dados está bloqueado 5 o banco de dados está bloqueado
SQLITE_LOCKED a tabela do banco de dados está bloqueada 6 a tabela do banco de dados está bloqueada
SQLITE_NOMEM sem memória 7 sem memória
SQLITE_READONLY tentativa de escrever em um banco de dados somente leitura 8 tentativa de escrever em um banco de dados somente leitura
SQLITE_INTERRUPT interrompido 9 interrompido
SQLITE_IOERR erro de E/S do disco 10 erro de E/S do disco
SQLITE_CORRUPT a imagem do disco do banco de dados está malformada 11 a imagem do disco do banco de dados está malformada
SQLITE_NOTFOUND 12 operação desconhecida
SQLITE_FULL o banco de dados ou o disco está cheio 13 o banco de dados ou o disco está cheio
SQLITE_CANTOPEN não foi possível abrir o arquivo do banco de dados 14 não foi possível abrir o arquivo do banco de dados
SQLITE_PROTOCOL protocolo de bloqueio 15 protocolo de bloqueio
SQLITE_EMPTY 16
SQLITE_SCHEMA o esquema do banco de dados foi alterado 17 o esquema do banco de dados foi alterado
SQLITE_TOOBIG string ou blob muito grande 18 string ou blob muito grande
SQLITE_CONSTRAINT restrição falhou 19 restrição falhou
SQLITE_MISMATCH incompatibilidade de tipo de dado 20 incompatibilidade de tipo de dado
SQLITE_MISUSE parâmetro inválido ou outro uso incorreto da API 21 parâmetro inválido ou outro uso incorreto da API
SQLITE_NOLFS 22
SQLITE_AUTH autorização negada 23 autorização negada
SQLITE_FORMAT 24
SQLITE_RANGE índice da coluna fora do intervalo 25 índice da coluna fora do intervalo
SQLITE_NOTADB arquivo não é um banco de dados 26 arquivo não é um banco de dados
SQLITE_NOTICE 27 mensagem de notificação
SQLITE_WARNING 28 mensagem de aviso
SQLITE_ROW 100 outra linha disponível
SQLITE_DONE 101 não há mais linhas disponíveis

Códigos de resultado estendidos

CódigoSignificado
SQLITE_OK_LOAD_PERMANENTLY 256
SQLITE_ERROR_MISSING_COLLSEQ sequência de collation inexistente 257 sequência de collation inexistente: unicode_ci
SQLITE_BUSY_RECOVERY outro processo está recuperando o WAL 261 o banco de dados está bloqueado
SQLITE_LOCKED_SHAREDCACHE registro bloqueado no cache compartilhado 262 a tabela do banco de dados está bloqueada
SQLITE_READONLY_RECOVERY 264
SQLITE_IOERR_READ 266
SQLITE_CORRUPT_VTAB 267
SQLITE_CANTOPEN_NOTEMPDIR 270
SQLITE_CONSTRAINT_CHECK falha na restrição CHECK 275 falha na restrição CHECK: price_positive
SQLITE_AUTH_USER 279
SQLITE_NOTICE_RECOVER_WAL 283
SQLITE_WARNING_AUTOINDEX 284
SQLITE_ERROR_RETRY 513
SQLITE_ABORT_ROLLBACK instrução abortada por ROLLBACK 516 abortado devido a ROLLBACK
SQLITE_BUSY_SNAPSHOT leitura obsoleta não pode se tornar uma escrita 517 o banco de dados está bloqueado
SQLITE_LOCKED_VTAB 518
SQLITE_READONLY_CANTLOCK 520
SQLITE_IOERR_SHORT_READ leitura retornou menos bytes 522 erro de E/S do disco
SQLITE_CORRUPT_SEQUENCE 523
SQLITE_CANTOPEN_ISDIR o caminho é um diretório 526 não foi possível abrir o arquivo do banco de dados
SQLITE_CONSTRAINT_COMMITHOOK 531
SQLITE_NOTICE_RECOVER_ROLLBACK 539
SQLITE_ERROR_SNAPSHOT 769
SQLITE_BUSY_TIMEOUT tempo limite de bloqueio de arquivo esgotado 773 o banco de dados está bloqueado
SQLITE_READONLY_ROLLBACK hot journal não pode ser revertido 776 tentativa de escrever em um banco de dados somente leitura
SQLITE_IOERR_WRITE 778
SQLITE_CORRUPT_INDEX entrada de índice ausente 779 a imagem do disco do banco de dados está malformada
SQLITE_CANTOPEN_FULLPATH 782
SQLITE_CONSTRAINT_FOREIGNKEY Falha na restrição de chave estrangeira 787 Falha na restrição de chave estrangeira
SQLITE_READONLY_DBMOVED o arquivo do banco de dados foi movido enquanto estava aberto 1032 tentativa de escrever em um banco de dados somente leitura
SQLITE_IOERR_FSYNC 1034
SQLITE_CANTOPEN_CONVPATH 1038
SQLITE_CONSTRAINT_FUNCTION 1043
SQLITE_READONLY_CANTINIT 1288
SQLITE_IOERR_DIR_FSYNC 1290
SQLITE_CANTOPEN_DIRTYWAL 1294
SQLITE_CONSTRAINT_NOTNULL Falha na restrição NOT NULL 1299 Falha na restrição NOT NULL: users.name
SQLITE_READONLY_DIRECTORY não é possível criar o arquivo de diário 1544 tentativa de escrever em um banco de dados somente leitura
SQLITE_IOERR_TRUNCATE 1546
SQLITE_CONSTRAINT_PRIMARYKEY falha na restrição de CHAVE PRIMÁRIA 1555 falha na restrição UNIQUE: orders.id
SQLITE_IOERR_FSTAT 1802
SQLITE_CONSTRAINT_TRIGGER RAISE() em um gatilho abortou-o 1811 restrição falhou
SQLITE_IOERR_UNLOCK 2058
SQLITE_CONSTRAINT_UNIQUE falha na restrição UNIQUE 2067 falha na restrição UNIQUE: users.email
SQLITE_IOERR_RDLOCK 2314
SQLITE_CONSTRAINT_VTAB 2323
SQLITE_IOERR_DELETE 2570
SQLITE_CONSTRAINT_ROWID 2579
SQLITE_IOERR_BLOCKED 2826
SQLITE_CONSTRAINT_PINNED 2835
SQLITE_IOERR_NOMEM 3082
SQLITE_CONSTRAINT_DATATYPE o valor não cabe em uma coluna STRICT 3091 não é possível armazenar valor TEXT na coluna INTEGER t.qty
SQLITE_IOERR_ACCESS 3338
SQLITE_IOERR_CHECKRESERVEDLOCK 3594
SQLITE_IOERR_LOCK 3850
SQLITE_IOERR_CLOSE 4106
SQLITE_IOERR_DIR_CLOSE 4362
SQLITE_IOERR_SHMOPEN 4618
SQLITE_IOERR_SHMSIZE 4874
SQLITE_IOERR_SHMLOCK 5130
SQLITE_IOERR_SHMMAP 5386
SQLITE_IOERR_SEEK 5642
SQLITE_IOERR_DELETE_NOENT 5898
SQLITE_IOERR_MMAP 6154
SQLITE_IOERR_GETTEMPPATH 6410
SQLITE_IOERR_CONVPATH 6666
SQLITE_IOERR_VNODE 6922
SQLITE_IOERR_AUTH 7178
SQLITE_IOERR_BEGIN_ATOMIC 7434
SQLITE_IOERR_COMMIT_ATOMIC 7690
SQLITE_IOERR_ROLLBACK_ATOMIC 7946
SQLITE_IOERR_DATA 8202
SQLITE_IOERR_CORRUPTFS 8458
// um cliente, todos os motores

Uma forma mais rápida de trabalhar com SQLite

O SQLly é um cliente SQL nativo para macOS, Windows e Linux, com IntelliSense baseado no esquema e proteções para instruções arriscadas.