SQLite: códigos de error

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.