SQLite: códigos de error

El código de resultado SQLITE_ABORT indica que una operación fue cancelada antes de su finalización, generalmente por solicitud de la aplicación. Ver también: SQLITE_INTERRUPT. Si la función de devolución de llamada a sqlite3_exec() devuelve un valor distinto de cero, entonces sqlite3_exec() devolverá SQLITE_ABORT. Si se produce una operación ROLLBACK en la misma conexión de base de datos que una lectura o escritura pendiente, entonces la lectura o escritura pendiente puede fallar con un error SQLITE_ABORT o SQLITE_ABORT_ROLLBACK. Además de ser un código de resultado, el valor SQLITE_ABORT también se utiliza como modo de resolución de conflictos devuelto desde la interfaz sqlite3_vtab_on_conflict().

El código de error SQLITE_ABORT_ROLLBACK es un código de error extendido para SQLITE_ABORT que indica que una instrucción SQL se canceló porque la transacción que estaba activa cuando se inició la instrucción SQL por primera vez se revirtió. Las operaciones de escritura pendientes siempre fallan con este error cuando se produce una reversión. Un ROLLBACK hará que una operación de lectura pendiente falle solo si el esquema se cambió dentro de la transacción que se está revirtiendo.

El error SQLITE_AUTH se devuelve cuando la devolución de llamada del autorizador indica que una declaración SQL que se está preparando no está autorizada.

El código de error SQLITE_AUTH_USER es un código de error extendido para SQLITE_AUTH que indica que se intentó una operación en una base de datos para la cual el usuario que inició sesión no tiene autorización suficiente.

El código de resultado SQLITE_BUSY indica que el archivo de base de datos no se pudo escribir (o en algunos casos leer) debido a la actividad simultánea de alguna otra conexión de base de datos, generalmente una conexión de base de datos en un proceso separado. Por ejemplo, si el proceso A está en medio de una transacción de escritura grande y al mismo tiempo el proceso B intenta iniciar una nueva transacción de escritura, el proceso B obtendrá un resultado SQLITE_BUSY porque SQLite solo admite un escritor a la vez. El proceso B deberá esperar a que el proceso A finalice su transacción antes de comenzar una nueva transacción. Las interfaces sqlite3_busy_timeout() y sqlite3_busy_handler() y el pragma ocupado_timeout están disponibles para procesar B para ayudarlo a lidiar con los errores SQLITE_BUSY. Un error SQLITE_BUSY puede ocurrir en cualquier punto de una transacción: cuando la transacción se inicia por primera vez, durante cualquier operación de escritura o actualización, o cuando se confirma la transacción. Para evitar encontrar errores SQLITE_BUSY en medio de una transacción, la aplicación puede usar BEGIN IMMEDIATE en lugar de simplemente BEGIN para iniciar una transacción. El comando BEGIN IMMEDIATE podría devolver SQLITE_BUSY, pero si tiene éxito, SQLite garantiza que ninguna operación posterior en la misma base de datos hasta el siguiente COMMIT devolverá SQLITE_BUSY. Ver también: SQLITE_BUSY_RECOVERY y SQLITE_BUSY_SNAPSHOT. El código de resultado SQLITE_BUSY difiere de SQLITE_LOCKED en que SQLITE_BUSY indica un conflicto con una conexión de base de datos separada, probablemente en un proceso separado, mientras que SQLITE_LOCKED indica un conflicto dentro de la misma conexión de base de datos (o, a veces, una conexión de base de datos con un caché compartido).

El código de error SQLITE_BUSY_RECOVERY es un código de error extendido para SQLITE_BUSY que indica que una operación no pudo continuar porque otro proceso está ocupado recuperando un archivo de base de datos en modo WAL luego de una falla. El código de error SQLITE_BUSY_RECOVERY solo ocurre en bases de datos en modo WAL.

El código de error SQLITE_BUSY_SNAPSHOT es un código de error extendido para SQLITE_BUSY que ocurre en bases de datos en modo WAL cuando una conexión de base de datos intenta promover una transacción de lectura a una transacción de escritura pero descubre que otra conexión de base de datos ya ha escrito en la base de datos y, por lo tanto, invalida las lecturas anteriores. El siguiente escenario ilustra cómo podría surgir un error SQLITE_BUSY_SNAPSHOT:

El código de error SQLITE_BUSY_TIMEOUT indica que una solicitud de bloqueo de archivo de aviso Posix en la capa VFS falló debido a un tiempo de espera. Los bloqueos de aviso de Posix solo están disponibles como una extensión patentada de SQLite e incluso entonces solo son compatibles si SQLite se compila con la opción de tiempo de compilación SQLITE_ENABLE_SETLK_TIMEOUT.

El código de resultado SQLITE_CANTOPEN indica que SQLite no pudo abrir un archivo. El archivo en cuestión puede ser un archivo de base de datos principal o uno de varios archivos de disco temporales.

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

El código de resultado SQLITE_CANTOPEN_DIRTYWAL no se utiliza en este momento.

El código de error SQLITE_CANTOPEN_FULLPATH es un código de error extendido para SQLITE_CANTOPEN que indica que una operación de apertura de archivo falló porque el sistema operativo no pudo convertir el nombre del archivo en una ruta completa.

El código de error SQLITE_CANTOPEN_ISDIR es un código de error extendido para SQLITE_CANTOPEN que indica que la operación de apertura de un archivo falló porque el archivo es en realidad un directorio.

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

El código de resultado SQLITE_CANTOPEN_SYMLINK lo devuelve la interfaz sqlite3_open() y sus hermanos cuando se usa el indicador SQLITE_OPEN_NOFOLLOW y el archivo de base de datos es un enlace simbólico.

El código de error SQLITE_CONSTRAINT significa que se produjo una infracción de la restricción SQL al intentar procesar una declaración SQL. Puede encontrar información adicional sobre la restricción fallida consultando el mensaje de error adjunto (devuelto mediante sqlite3_errmsg() o sqlite3_errmsg16()) o mirando el código de error extendido. El código SQLITE_CONSTRAINT también se puede utilizar como valor de retorno del método xBestIndex() de una implementación de tabla virtual. Cuando xBestIndex() devuelve SQLITE_CONSTRAINT, eso indica que la combinación particular de entradas enviadas a xBestIndex() no puede dar como resultado un plan de consulta utilizable y no se le debe dar más consideración.

El código de error SQLITE_CONSTRAINT_CHECK es un código de error extendido para SQLITE_CONSTRAINT que indica que falló una restricción CHECK.

El código de error SQLITE_CONSTRAINT_COMMITHOOK es un código de error extendido para SQLITE_CONSTRAINT que indica que una devolución de llamada del enlace de confirmación devolvió un valor distinto de cero, lo que provocó que la instrucción SQL se revirtiera.

El código de error SQLITE_CONSTRAINT_DATATYPE es un código de error extendido para SQLITE_CONSTRAINT que indica que una inserción o actualización intentó almacenar un valor inconsistente con el tipo declarado de la columna en una tabla definida como STRICT.

El código de error SQLITE_CONSTRAINT_FOREIGNKEY es un código de error extendido para SQLITE_CONSTRAINT que indica que falló una restricción de clave externa.

El código de error SQLITE_CONSTRAINT_FUNCTION no lo utiliza actualmente el núcleo de SQLite. Sin embargo, este código de error está disponible para que lo utilicen las funciones de extensión.

El código de error SQLITE_CONSTRAINT_NOTNULL es un código de error extendido para SQLITE_CONSTRAINT que indica que falló una restricción NOT NULL.

El código de error SQLITE_CONSTRAINT_PINNED es un código de error extendido para SQLITE_CONSTRAINT que indica que un activador de ACTUALIZACIÓN intentó eliminar la fila que se estaba actualizando en medio de la actualización.

El código de error SQLITE_CONSTRAINT_PRIMARYKEY es un código de error extendido para SQLITE_CONSTRAINT que indica que falló una restricción PRIMARY KEY.

El código de error SQLITE_CONSTRAINT_ROWID es un código de error extendido para SQLITE_CONSTRAINT que indica que un ID de fila no es único.

El código de error SQLITE_CONSTRAINT_TRIGGER es un código de error extendido para SQLITE_CONSTRAINT que indica que se activó una función RAISE dentro de un disparador, lo que provocó que se cancelara la instrucción SQL.

El código de error SQLITE_CONSTRAINT_UNIQUE es un código de error extendido para SQLITE_CONSTRAINT que indica que falló una restricción UNIQUE.

El código de error SQLITE_CONSTRAINT_VTAB no lo utiliza actualmente el núcleo de SQLite. Sin embargo, este código de error está disponible para su uso en tablas virtuales definidas por la aplicación.

El código de resultado SQLITE_CORRUPT indica que el archivo de la base de datos ha sido dañado. Consulte Cómo dañar los archivos de su base de datos para obtener más información sobre cómo puede ocurrir la corrupción.

El código de resultado SQLITE_CORRUPT_INDEX significa que SQLite detectó que falta una entrada en un índice. Este es un caso especial del código de error SQLITE_CORRUPT que sugiere que el problema podría resolverse ejecutando el comando REINDEX, suponiendo que no existan otros problemas en otras partes del archivo de base de datos.

El código de resultado SQLITE_CORRUPT_SEQUENCE significa que el esquema de la tabla sqlite_sequence está dañado. La tabla sqlite_sequence se utiliza para ayudar a implementar la función AUTOINCREMENT. La tabla sqlite_sequence debe tener el siguiente formato: Si SQLite descubre que la tabla sqlite_sequence tiene cualquier otro formato, devuelve el error SQLITE_CORRUPT_SEQUENCE.

El código de error SQLITE_CORRUPT_VTAB es un código de error extendido para SQLITE_CORRUPT utilizado por tablas virtuales. Una tabla virtual puede devolver SQLITE_CORRUPT_VTAB para indicar que el contenido de la tabla virtual está dañado.

El código de resultado SQLITE_EMPTY no se utiliza actualmente.

El código de resultado SQLITE_ERROR es un código de error genérico que se utiliza cuando no hay disponible otro código de error más específico.

El código de resultado SQLITE_ERROR_MISSING_COLLSEQ significa que no se pudo preparar una declaración SQL porque no se pudo ubicar una secuencia de clasificación nombrada en esa declaración SQL. A veces, cuando se encuentra este código de error, la rutina sqlite3_prepare_v2() convertirá el error en SQLITE_ERROR_RETRY e intentará nuevamente preparar la declaración SQL utilizando un plan de consulta diferente que no requiera el uso de la secuencia de clasificación desconocida.

SQLITE_ERROR_RETRY se usa internamente para provocar que sqlite3_prepare_v2() (o una de sus rutinas hermanas para crear declaraciones preparadas) intente nuevamente preparar una declaración que falló con un error en el intento anterior.

Es posible que se devuelva el código de resultado SQLITE_ERROR_SNAPSHOT al intentar iniciar una transacción de lectura en una versión histórica de la base de datos mediante la interfaz sqlite3_snapshot_open(). Si la instantánea histórica ya no está disponible, la transacción de lectura fallará con SQLITE_ERROR_SNAPSHOT. Este código de error solo es posible si SQLite se compila con -DSQLITE_ENABLE_SNAPSHOT.

SQLite no utiliza actualmente el código de error SQLITE_FORMAT.

El código de resultado SQLITE_FULL indica que no se pudo completar una escritura porque el disco está lleno. Tenga en cuenta que este error puede ocurrir al intentar escribir información en el archivo de base de datos principal, o también puede ocurrir al escribir en archivos de disco temporales. A veces las aplicaciones encuentran este error a pesar de que hay mucho espacio en el disco primario porque el error ocurre al escribir en archivos de disco temporales en un sistema donde los archivos temporales se almacenan en una partición separada con mucho menos espacio que el disco primario.

El código de resultado SQLITE_INTERNAL indica un mal funcionamiento interno. En una versión funcional de SQLite, una aplicación nunca debería ver este código de resultado. Si la aplicación encuentra este código de resultado, muestra que hay un error en el motor de la base de datos. Este código de resultado puede deberse a un error en SQLite. Sin embargo, las funciones SQL definidas por la aplicación, tablas virtuales, VFS u otras extensiones también pueden provocar que se devuelva este código de resultado, por lo que es posible que el problema no sea culpa del SQLite principal.