Códigos de error de SQLite
Todos los códigos de resultado de SQLite de la lista oficial, primarios y extendidos, con el texto sqlite3_errstr() devuelve para cada código principal. Los que es probable que encuentres tienen una página completa con causas y soluciones.
Leyendo un error de SQLite
Las funciones de SQLite devuelven un código de resultado entero. Los ocho bits bajos son el código principal, como SQLITE_BUSY (5). Los códigos extendidos añaden detalle en los bits superiores: SQLITE_BUSY_SNAPSHOT es 517, que es 5 + 2 × 256. Los códigos extendidos se devuelven cuando se habilitan con sqlite3_extended_result_codes() o se leen con sqlite3_extended_errcode().
El mensaje que muestra un programa suele venir de sqlite3_errmsg(), que puede ser más específico que el texto genérico, por ejemplo UNIQUE constraint failed: users.email en lugar de constraint failed.
Los bindings de lenguaje envuelven estos códigos: el módulo sqlite3 de Python lanza OperationalError o IntegrityError y, desde Python 3.11, expone sqlite_errorcode y sqlite_errorname en la excepción.
Todos los errores de SQLite en esta referencia
105 códigos, 40 con una descripción completa (enlazada). Los códigos y mensajes provienen de la Documentación de los códigos de resultado y de error de SQLite.
Códigos de resultado primarios
| Código | Significado |
|---|---|
SQLITE_OK
|
0
no es un error
|
SQLITE_ERROR
|
Error de lógica SQL
1
Error de lógica SQL
|
SQLITE_INTERNAL
|
2
|
SQLITE_PERM
|
permiso de acceso denegado
3
permiso de acceso denegado
|
SQLITE_ABORT
|
consulta abortada
4
consulta abortada
|
SQLITE_BUSY
|
la base de datos está bloqueada
5
la base de datos está bloqueada
|
SQLITE_LOCKED
|
la tabla de la base de datos está bloqueada
6
la tabla de la base de datos está bloqueada
|
SQLITE_NOMEM
|
memoria agotada
7
memoria agotada
|
SQLITE_READONLY
|
intento de escribir en una base de datos de solo lectura
8
intento de escribir en una base de datos de solo lectura
|
SQLITE_INTERRUPT
|
interrumpido
9
interrumpido
|
SQLITE_IOERR
|
error de E/S de disco
10
error de E/S de disco
|
SQLITE_CORRUPT
|
la imagen de disco de la base de datos está dañada
11
la imagen de disco de la base de datos está dañada
|
SQLITE_NOTFOUND
|
12
operación desconocida
|
SQLITE_FULL
|
la base de datos o el disco están llenos
13
la base de datos o el disco están llenos
|
SQLITE_CANTOPEN
|
no se puede abrir el archivo de base de datos
14
no se puede abrir el archivo de base de datos
|
SQLITE_PROTOCOL
|
protocolo de bloqueo
15
protocolo de bloqueo
|
SQLITE_EMPTY
|
16
|
SQLITE_SCHEMA
|
el esquema de la base de datos ha cambiado
17
el esquema de la base de datos ha cambiado
|
SQLITE_TOOBIG
|
cadena o blob demasiado grande
18
cadena o blob demasiado grande
|
SQLITE_CONSTRAINT
|
restricción fallida
19
restricción fallida
|
SQLITE_MISMATCH
|
incompatibilidad de tipos de datos
20
incompatibilidad de tipos de datos
|
SQLITE_MISUSE
|
parámetro incorrecto u otro uso indebido de la API
21
parámetro incorrecto u otro uso indebido de la API
|
SQLITE_NOLFS
|
22
|
SQLITE_AUTH
|
autorización denegada
23
autorización denegada
|
SQLITE_FORMAT
|
24
|
SQLITE_RANGE
|
índice de columna fuera de rango
25
índice de columna fuera de rango
|
SQLITE_NOTADB
|
el archivo no es una base de datos
26
el archivo no es una base de datos
|
SQLITE_NOTICE
|
27
mensaje de notificación
|
SQLITE_WARNING
|
28
mensaje de advertencia
|
SQLITE_ROW
|
100
otra fila disponible
|
SQLITE_DONE
|
101
no hay más filas disponibles
|
Códigos de resultado extendidos
| Código | Significado |
|---|---|
SQLITE_OK_LOAD_PERMANENTLY
|
256
|
SQLITE_ERROR_MISSING_COLLSEQ
|
no existe la secuencia de intercalación
257
no existe la secuencia de intercalación: unicode_ci
|
SQLITE_BUSY_RECOVERY
|
otro proceso está recuperando el WAL
261
la base de datos está bloqueada
|
SQLITE_LOCKED_SHAREDCACHE
|
registro bloqueado en la caché compartida
262
la tabla de la base de datos está bloqueada
|
SQLITE_READONLY_RECOVERY
|
264
|
SQLITE_IOERR_READ
|
266
|
SQLITE_CORRUPT_VTAB
|
267
|
SQLITE_CANTOPEN_NOTEMPDIR
|
270
|
SQLITE_CONSTRAINT_CHECK
|
fallo en la restricción CHECK
275
fallo en la restricción CHECK: price_positive
|
SQLITE_AUTH_USER
|
279
|
SQLITE_NOTICE_RECOVER_WAL
|
283
|
SQLITE_WARNING_AUTOINDEX
|
284
|
SQLITE_ERROR_RETRY
|
513
|
SQLITE_ABORT_ROLLBACK
|
instrucción abortada por ROLLBACK
516
abortado por ROLLBACK
|
SQLITE_BUSY_SNAPSHOT
|
una lectura obsoleta no puede convertirse en escritura
517
la base de datos está bloqueada
|
SQLITE_LOCKED_VTAB
|
518
|
SQLITE_READONLY_CANTLOCK
|
520
|
SQLITE_IOERR_SHORT_READ
|
la lectura devolvió menos bytes
522
error de E/S de disco
|
SQLITE_CORRUPT_SEQUENCE
|
523
|
SQLITE_CANTOPEN_ISDIR
|
la ruta es un directorio
526
no se puede abrir el archivo de base de datos
|
SQLITE_CONSTRAINT_COMMITHOOK
|
531
|
SQLITE_NOTICE_RECOVER_ROLLBACK
|
539
|
SQLITE_ERROR_SNAPSHOT
|
769
|
SQLITE_BUSY_TIMEOUT
|
tiempo de espera superado para el bloqueo de archivo
773
la base de datos está bloqueada
|
SQLITE_READONLY_ROLLBACK
|
el diario caliente no se puede revertir
776
intento de escribir en una base de datos de solo lectura
|
SQLITE_IOERR_WRITE
|
778
|
SQLITE_CORRUPT_INDEX
|
entrada de índice faltante
779
la imagen de disco de la base de datos está dañada
|
SQLITE_CANTOPEN_FULLPATH
|
782
|
SQLITE_CONSTRAINT_FOREIGNKEY
|
Se violó la restricción FOREIGN KEY
787
Se violó la restricción FOREIGN KEY
|
SQLITE_READONLY_DBMOVED
|
archivo de base de datos movido mientras estaba abierto
1032
intento de escribir en una base de datos de solo lectura
|
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
|
Se violó la restricción NOT NULL
1299
Se violó la restricción NOT NULL: users.name
|
SQLITE_READONLY_DIRECTORY
|
no se puede crear el archivo de diario
1544
intento de escribir en una base de datos de solo lectura
|
SQLITE_IOERR_TRUNCATE
|
1546
|
SQLITE_CANTOPEN_SYMLINK
|
1550
|
SQLITE_CONSTRAINT_PRIMARYKEY
|
Falló la restricción de PRIMARY KEY
1555
Falló la restricción UNIQUE: orders.id
|
SQLITE_IOERR_FSTAT
|
1802
|
SQLITE_CONSTRAINT_TRIGGER
|
RAISE() en un trigger lo abortó
1811
restricción fallida
|
SQLITE_IOERR_UNLOCK
|
2058
|
SQLITE_CONSTRAINT_UNIQUE
|
Falló la restricción UNIQUE
2067
Falló la restricción 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
|
el valor no cabe en una columna STRICT
3091
no se puede almacenar un valor TEXT en la columna 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
|
Una forma más rápida de trabajar con SQLite
SQLly es un cliente SQL nativo para macOS, Windows y Linux, con IntelliSense que entiende el esquema y protecciones frente a instrucciones peligrosas.