// referencia de errores

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ódigoSignificado
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ódigoSignificado
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_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
// un cliente, todos los motores

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.