SQLite: códigos de error

El código de resultado SQLITE_INTERRUPT indica que la interfaz sqlite3_interrupt() interrumpió una operación. Ver también: SQLITE_ABORT

El código de resultado SQLITE_IOERR dice que la operación no pudo finalizar porque el sistema operativo informó un error de E/S. Una unidad de disco llena normalmente dará un error SQLITE_FULL en lugar de un error SQLITE_IOERR. Hay muchos códigos de resultados extendidos diferentes para errores de E/S que identifican la operación de E/S específica que falló.

El código de error SQLITE_IOERR_ACCESS es un código de error extendido para SQLITE_IOERR que indica un error de E/S dentro del método xAccess en el objeto sqlite3_vfs.

El código de error SQLITE_IOERR_AUTH es un código reservado para uso de extensiones. No lo utiliza el núcleo de SQLite.

El código de error SQLITE_IOERR_BEGIN_ATOMIC indica que el sistema operativo subyacente informó un error en el control de archivos SQLITE_FCNTL_BEGIN_ATOMIC_WRITE. Esto solo aparece cuando SQLITE_ENABLE_ATOMIC_WRITE está habilitado y la base de datos está alojada en un sistema de archivos que admite escrituras atómicas.

El código de error SQLITE_IOERR_BLOCKED ya no se utiliza.

El código de error SQLITE_IOERR_CHECKRESERVEDLOCK es un código de error extendido para SQLITE_IOERR que indica un error de E/S dentro del método xCheckReservedLock en el objeto sqlite3_io_methods.

El código de error SQLITE_IOERR_CLOSE es un código de error extendido para SQLITE_IOERR que indica un error de E/S dentro del método xClose en el objeto sqlite3_io_methods.

El código de error SQLITE_IOERR_COMMIT_ATOMIC indica que el sistema operativo subyacente informó un error en el control de archivos SQLITE_FCNTL_COMMIT_ATOMIC_WRITE. Esto solo aparece cuando SQLITE_ENABLE_ATOMIC_WRITE está habilitado y la base de datos está alojada en un sistema de archivos que admite escrituras atómicas.

El código de error SQLITE_IOERR_CONVPATH es un código de error extendido para SQLITE_IOERR utilizado solo por Cygwin VFS e indica que la llamada al sistema cygwin_conv_path() falló. Ver también: SQLITE_CANTOPEN_CONVPATH

El código de error SQLITE_IOERR_CORRUPTFS es un código de error extendido para SQLITE_IOERR usado solo por un VFS para indicar que una falla de búsqueda o lectura se debió a que la solicitud no se encontraba dentro de los límites del archivo en lugar de a una falla normal del dispositivo. Esto suele indicar un sistema de archivos corrupto. Esta página se actualizó por última vez el 2026-02-18 11:56:50Z

El código de error SQLITE_IOERR_DATA es un código de error extendido para SQLITE_IOERR utilizado solo por la cuña VFS de suma de verificación para indicar que la suma de verificación en una página del archivo de base de datos es incorrecta.

El código de error SQLITE_IOERR_DELETE es un código de error extendido para SQLITE_IOERR que indica un error de E/S dentro del método xDelete en el objeto sqlite3_vfs.

El código de error SQLITE_IOERR_DELETE_NOENT es un código de error extendido para SQLITE_IOERR que indica que el método xDelete en el objeto sqlite3_vfs falló porque el archivo que se está eliminando no existe.

El código de error SQLITE_IOERR_DIR_CLOSE ya no se utiliza.

El código de error SQLITE_IOERR_DIR_FSYNC es un código de error extendido para SQLITE_IOERR que indica un error de E/S en la capa VFS al intentar invocar fsync() en un directorio. Unix VFS intenta fsync() directorios después de crear o eliminar ciertos archivos para garantizar que esos archivos seguirán apareciendo en el sistema de archivos después de una pérdida de energía o una falla del sistema. Este código de error indica un problema al intentar realizar ese fsync().

El código de error SQLITE_IOERR_FSTAT es un código de error extendido para SQLITE_IOERR que indica un error de E/S en la capa VFS al intentar invocar fstat() (o su equivalente) en un archivo para determinar información como el tamaño del archivo o los permisos de acceso.

El código de error SQLITE_IOERR_FSYNC es un código de error extendido para SQLITE_IOERR que indica un error de E/S en la capa VFS al intentar eliminar contenido previamente escrito del sistema operativo y/o de los buffers de control de disco y al almacenamiento persistente. En otras palabras, este código indica un problema con la llamada al sistema fsync() en Unix o la llamada al sistema FlushFileBuffers() en Windows.

El código de error SQLITE_IOERR_GETTEMPPATH es un código de error extendido para SQLITE_IOERR que indica que el VFS no puede determinar un directorio adecuado para colocar archivos temporales.

El código de error SQLITE_IOERR_LOCK es un código de error extendido para SQLITE_IOERR que indica un error de E/S en la lógica de bloqueo del archivo de aviso. Por lo general, un error SQLITE_IOERR_LOCK indica un problema al obtener un bloqueo PENDIENTE. Sin embargo, también puede indicar varios errores de bloqueo en algunos de los VFS especializados utilizados en Mac.

El código de error SQLITE_IOERR_MMAP es un código de error extendido para SQLITE_IOERR que indica un error de E/S dentro de los métodos xFetch o xUnfetch en el objeto sqlite3_io_methods al intentar asignar o desasignar parte del archivo de base de datos en el espacio de direcciones del proceso.

A veces, la capa VFS devuelve el código de error SQLITE_IOERR_NOMEM para indicar que no se pudo completar una operación debido a la imposibilidad de asignar suficiente memoria. Este código de error normalmente lo convierten a SQLITE_NOMEM las capas superiores de SQLite antes de devolverlo a la aplicación.

El código de error SQLITE_IOERR_RDLOCK es un código de error extendido para SQLITE_IOERR que indica un error de E/S dentro del método xLock en el objeto sqlite3_io_methods al intentar obtener un bloqueo de lectura.

El código de error SQLITE_IOERR_READ es un código de error extendido para SQLITE_IOERR que indica un error de E/S en la capa VFS al intentar leer un archivo en el disco. Este error puede deberse a un mal funcionamiento del hardware o a que un sistema de archivos se desmontó mientras el archivo estaba abierto.

El código de error SQLITE_IOERR_ROLLBACK_ATOMIC indica que el sistema operativo subyacente informó un error en el control de archivos SQLITE_FCNTL_ROLLBACK_ATOMIC_WRITE. Esto solo aparece cuando SQLITE_ENABLE_ATOMIC_WRITE está habilitado y la base de datos está alojada en un sistema de archivos que admite escrituras atómicas.

El código de error SQLITE_IOERR_SEEK es un código de error extendido para SQLITE_IOERR que indica un error de E/S dentro de los métodos xRead o xWrite en el objeto sqlite3_io_methods al intentar buscar un descriptor de archivo en el punto inicial del archivo donde se producirá la lectura o escritura.

El código de error SQLITE_IOERR_SHMLOCK ya no se utiliza.

El código de error SQLITE_IOERR_SHMMAP es un código de error extendido para SQLITE_IOERR que indica un error de E/S dentro del método xShmMap en el objeto sqlite3_io_methods al intentar asignar un segmento de memoria compartida al espacio de direcciones del proceso.

El código de error SQLITE_IOERR_SHMOPEN es un código de error extendido para SQLITE_IOERR que indica un error de E/S dentro del método xShmMap en el objeto sqlite3_io_methods al intentar abrir un nuevo segmento de memoria compartida.

El código de error SQLITE_IOERR_SHMSIZE es un código de error extendido para SQLITE_IOERR que indica un error de E/S dentro del método xShmMap en el objeto sqlite3_io_methods al intentar ampliar un archivo "shm" como parte del procesamiento de transacciones en modo WAL. Este error puede indicar que el volumen del sistema de archivos subyacente no tiene espacio.

El código de error SQLITE_IOERR_SHORT_READ es un código de error extendido para SQLITE_IOERR que indica que un intento de lectura en la capa VFS no pudo obtener tantos bytes como se solicitó. Esto podría deberse a un archivo truncado.

El código de error SQLITE_IOERR_TRUNCATE es un código de error extendido para SQLITE_IOERR que indica un error de E/S en la capa VFS al intentar cambiar el tamaño de un archivo usando el método xTruncate del objeto sqlite3_io_methods.

El código de error SQLITE_IOERR_UNLOCK es un código de error extendido para SQLITE_IOERR que indica un error de E/S dentro del método xUnlock en el objeto sqlite3_io_methods.

El código de error SQLITE_IOERR_VNODE es un código reservado para uso de extensiones. No lo utiliza el núcleo de SQLite.

El código de error SQLITE_IOERR_WRITE es un código de error extendido para SQLITE_IOERR que indica un error de E/S en la capa VFS al intentar escribir en un archivo en el disco. Este error puede deberse a un mal funcionamiento del hardware o a que un sistema de archivos se desmontó mientras el archivo estaba abierto. Este error no debería ocurrir si el sistema de archivos está lleno ya que existe un código de error separado (SQLITE_FULL) para ese propósito.

El código de resultado SQLITE_LOCKED indica que una operación de escritura no pudo continuar debido a un conflicto dentro de la misma conexión de base de datos o un conflicto con una conexión de base de datos diferente que utiliza un caché compartido. Por ejemplo, una instrucción DROP TABLE no se puede ejecutar mientras otro subproceso está leyendo esa tabla en la misma conexión de base de datos porque eliminar la tabla eliminaría la tabla del lector concurrente. El código de resultado SQLITE_LOCKED difiere de SQLITE_BUSY en que SQLITE_LOCKED indica un conflicto en la misma conexión de base de datos (o en una conexión con un caché compartido) mientras que SQLITE_BUSY indica un conflicto con una conexión de base de datos diferente, probablemente en un proceso diferente.

El código de resultado SQLITE_LOCKED_SHAREDCACHE indica que el acceso a un registro de datos SQLite está bloqueado por otra conexión de base de datos que utiliza el mismo registro en modo de caché compartido. Cuando dos o más conexiones de bases de datos comparten el mismo caché y una de las conexiones está modificando un registro en ese caché, otras conexiones no pueden acceder a esos datos mientras las modificaciones están en curso para evitar que los lectores vean un cambio corrupto o parcialmente completado.

El código de resultado SQLITE_LOCKED_VTAB no lo utiliza el núcleo de SQLite, pero está disponible para que lo utilicen las extensiones. Las implementaciones de tablas virtuales pueden devolver este código de resultado para indicar que no pueden completar la operación actual debido a bloqueos mantenidos por otros subprocesos o procesos. La extensión R-Tree devuelve este código de resultado cuando se intenta actualizar R-Tree mientras otra declaración preparada lee activamente R-Tree. La actualización no puede continuar porque cualquier cambio en un R-Tree podría implicar la reorganización y el reequilibrio de los nodos, lo que interrumpiría los cursores de lectura y provocaría que algunas filas se repitan y otras se omitan.

El código de error SQLITE_MISMATCH indica una discrepancia en el tipo de datos. SQLite normalmente es muy indulgente con las discrepancias entre el tipo de un valor y el tipo declarado del contenedor en el que se almacenará ese valor. Por ejemplo, SQLite permite que la aplicación almacene un BLOB grande en una columna con un tipo declarado BOOLEAN. Pero en algunos casos, SQLite es estricto con los tipos. El error SQLITE_MISMATCH se devuelve en aquellos pocos casos en los que los tipos no coinciden. El ID de fila de una tabla debe ser un número entero. Intentar establecer el ID de fila en cualquier valor que no sea un número entero (o un NULL que se convertirá automáticamente en el siguiente ID de fila entero disponible) genera un error SQLITE_MISMATCH.

Es posible que se devuelva el código de retorno SQLITE_MISUSE si la aplicación utiliza cualquier interfaz SQLite de una manera que no está definida o no es compatible. Por ejemplo, el uso de una declaración preparada después de que se haya finalizado puede generar un error SQLITE_MISUSE. SQLite intenta detectar el uso indebido e informarlo utilizando este código de resultado. Sin embargo, no hay garantía de que la detección del uso indebido sea exitosa. La detección del mal uso es probabilística. Las aplicaciones nunca deberían depender de un valor de retorno SQLITE_MISUSE. Si SQLite alguna vez devuelve SQLITE_MISUSE desde cualquier interfaz, eso significa que la aplicación está codificada incorrectamente y necesita ser reparada. No envíe una aplicación que a veces devuelva SQLITE_MISUSE desde una interfaz SQLite estándar porque esa aplicación contiene errores potencialmente graves.