Buscar códigos de error

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.

El error SQLITE_NOLFS se puede devolver en sistemas que no admiten archivos grandes cuando la base de datos crece hasta ser más grande de lo que el sistema de archivos puede manejar. "NOLFS" significa "NO admite archivos grandes".

El código de resultado SQLITE_NOMEM indica que SQLite no pudo asignar toda la memoria que necesitaba para completar la operación. En otras palabras, una llamada interna a sqlite3_malloc() o sqlite3_realloc() falló en un caso en el que la memoria asignada era necesaria para continuar la operación.

Al intentar abrir un archivo, el error SQLITE_NOTADB indica que el archivo que se está abriendo no parece ser un archivo de base de datos SQLite.

El código de resultado SQLITE_NOTFOUND se expone de tres maneras: El código de resultado SQLITE_NOTFOUND también lo usa internamente la implementación de SQLite, pero esos usos internos no están expuestos a la aplicación.

El código de resultado SQLITE_NOTICE no lo devuelve ninguna interfaz C/C++. Sin embargo, SQLITE_NOTICE (o más bien uno de sus códigos de error extendidos) a veces se usa como primer argumento en una devolución de llamada sqlite3_log() para indicar que se está llevando a cabo una operación inusual.

El código de resultado SQLITE_NOTICE_RECOVER_ROLLBACK se pasa a la devolución de llamada de sqlite3_log() cuando se revierte un diario activo.

El código de resultado SQLITE_NOTICE_RECOVER_WAL se pasa a la devolución de llamada de sqlite3_log() cuando se recupera un archivo de base de datos en modo WAL.

El código de resultado SQLITE_PERM indica que no se pudo proporcionar el modo de acceso solicitado para una base de datos recién creada.

El código de resultado SQLITE_PROTOCOL indica un problema con el protocolo de bloqueo de archivos utilizado por SQLite. Actualmente, el error SQLITE_PROTOCOL solo se devuelve cuando se utiliza el modo WAL y se intenta iniciar una nueva transacción. Existe una condición de carrera que puede ocurrir cuando dos conexiones de bases de datos separadas intentan iniciar una transacción al mismo tiempo en modo WAL. El perdedor de la carrera retrocede y vuelve a intentarlo, tras un breve retraso. Si la misma conexión pierde la carrera de bloqueo docenas de veces en un lapso de varios segundos, eventualmente se dará por vencida y devolverá SQLITE_PROTOCOL. El error SQLITE_PROTOCOL debería aparecer en la práctica muy, muy raramente, y sólo cuando hay muchos procesos separados que compiten intensamente para escribir en la misma base de datos.

El error SQLITE_RANGE indica que el argumento del número de parámetro de una de las rutinas sqlite3_bind o el número de columna en una de las rutinas sqlite3_column está fuera de rango.

El código de resultado SQLITE_READONLY se devuelve cuando se intenta modificar algunos datos para los cuales la conexión de base de datos actual no tiene permiso de escritura.

El código de resultado SQLITE_READONLY_CANTINIT se origina en el método xShmMap de un VFS para indicar que la región de memoria compartida utilizada por el modo WAL existe pero su contenido no es confiable y no puede ser utilizado por el proceso actual ya que el proceso actual no tiene permiso de escritura en la región de memoria compartida. (La región de memoria compartida para el modo WAL es normalmente un archivo con un sufijo "-wal" que se asigna al espacio del proceso. Si el proceso actual no tiene permiso de escritura en ese archivo, entonces no puede escribir en la memoria compartida). La lógica de nivel superior dentro de SQLite normalmente interceptará el código de error y creará una región de memoria compartida temporal en memoria para que el proceso actual pueda al menos leer el contenido de la base de datos. Este código de resultado no debe llegar a la capa de interfaz de la aplicación.

El código de error SQLITE_READONLY_CANTLOCK es un código de error extendido para SQLITE_READONLY. El código de error SQLITE_READONLY_CANTLOCK indica que SQLite no puede obtener un bloqueo de lectura en una base de datos en modo WAL porque el archivo de memoria compartida asociado con esa base de datos es de solo lectura.

El código de error SQLITE_READONLY_DBMOVED es un código de error extendido para SQLITE_READONLY. El código de error SQLITE_READONLY_DBMOVED indica que una base de datos no se puede modificar porque el archivo de la base de datos se ha movido desde que se abrió y, por lo tanto, cualquier intento de modificar la base de datos podría provocar daños en la base de datos si el proceso falla porque el diario de reversión no tendría el nombre correcto.

El código de resultado SQLITE_READONLY_DIRECTORY indica que la base de datos es de solo lectura porque el proceso no tiene permiso para crear un archivo de diario en el mismo directorio que la base de datos y la creación de un archivo de diario es un requisito previo para la escritura.

El código de error SQLITE_READONLY_RECOVERY es un código de error extendido para SQLITE_READONLY. El código de error SQLITE_READONLY_RECOVERY indica que no se puede abrir una base de datos en modo WAL porque el archivo de la base de datos debe recuperarse y la recuperación requiere acceso de escritura, pero solo está disponible el acceso de lectura.

El código de error SQLITE_READONLY_ROLLBACK es un código de error extendido para SQLITE_READONLY. El código de error SQLITE_READONLY_ROLLBACK indica que no se puede abrir una base de datos porque tiene un diario activo que debe revertirse, pero no puede porque la base de datos es de solo lectura.

El código de resultado SQLITE_SCHEMA indica que el esquema de la base de datos ha cambiado. Este código de resultado se puede devolver desde sqlite3_step() para una declaración preparada que se generó usando sqlite3_prepare() o sqlite3_prepare16(). Si algún otro proceso cambió el esquema de la base de datos entre el momento en que se preparó la declaración y el momento en que se ejecutó, se puede producir este error. Si se genera una declaración preparada desde sqlite3_prepare_v2(), entonces la declaración se vuelve a preparar automáticamente si el esquema cambia, hasta SQLITE_MAX_SCHEMA_RETRY veces (predeterminado: 50). La interfaz sqlite3_step() solo devolverá SQLITE_SCHEMA a la aplicación si el error persiste después de tantos reintentos.

El código de error SQLITE_TOOBIG indica que una cadena o BLOB era demasiado grande. La longitud máxima predeterminada de una cadena o BLOB en SQLite es 1.000.000.000 bytes. Esta longitud máxima se puede cambiar en tiempo de compilación usando la opción de tiempo de compilación SQLITE_MAX_LENGTH, o en tiempo de ejecución usando la interfaz sqlite3_limit(db,SQLITE_LIMIT_LENGTH,...). El error SQLITE_TOOBIG se produce cuando SQLite encuentra una cadena o BLOB que excede el límite de tiempo de compilación o de ejecución. El código de error SQLITE_TOOBIG también puede aparecer cuando se pasa una declaración SQL de gran tamaño a una de las interfaces sqlite3_prepare_v2(). La longitud máxima de una declaración SQL tiene por defecto un valor similar de 1.000.000.000 bytes. La longitud máxima de la declaración SQL se puede establecer en tiempo de compilación usando SQLITE_MAX_SQL_LENGTH o en tiempo de ejecución usando sqlite3_limit(db,SQLITE_LIMIT_SQL_LENGTH,...).

El código de resultado SQLITE_WARNING no lo devuelve ninguna interfaz C/C++. Sin embargo, SQLITE_WARNING (o más bien uno de sus códigos de error extendidos) a veces se usa como primer argumento en una devolución de llamada sqlite3_log() para indicar que se está llevando a cabo una operación inusual y posiblemente desacertada.

El código de resultado SQLITE_WARNING_AUTOINDEX se pasa a la devolución de llamada de sqlite3_log() siempre que se utiliza la indexación automática. Esto puede servir como advertencia a los diseñadores de aplicaciones de que la base de datos podría beneficiarse de índices adicionales.