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ódigo | Significado |
|---|---|
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ódigo | Significado |
|---|---|
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_CANTOPEN_SYMLINK
|
1550
|
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
|
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.