SQLite : codes d’erreur

Le code de résultat SQLITE_ABORT indique qu'une opération a été interrompue avant la fin, habituellement par demande d'application. Voir aussi : SQLITE_INTERRUPT. Si la fonction callback à sqlite3_exec() retourne non-zéro, sqlite3_exec() retourne SQLITE_ABORT. Si une opération ROLLBACK se produit sur la même connexion de base de données qu'une lecture ou une écriture en attente, alors la lecture ou l'écriture en attente peut échouer avec une erreur SQLITE_ABORT ou SQLITE_ABORT_ROLLBACK. En plus d'être un code de résultat, la valeur SQLITE_ABORT est également utilisée comme mode de résolution de conflits retourné depuis l'interface sqlite3_vtab_on_conflict().

Le code d'erreur SQLITE_ABORT_ROLLBACK est un code d'erreur étendu pour SQLITE_ABORT indiquant qu'une instruction SQL a été annulée parce que la transaction active lors du premier démarrage de l'instruction SQL a été renversée. Les opérations d'écriture en attente échouent toujours avec cette erreur lorsqu'un renversement se produit.

L'erreur SQLITE_AUTH est retournée lorsque le callback de l'autorisateur indique qu'une instruction SQL en cours de préparation n'est pas autorisée.

Le code d'erreur SQLITE_AUTH_USER est un code d'erreur étendu pour SQLITE_AUTH indiquant qu'une opération a été tentée dans une base de données pour laquelle l'utilisateur connecté manque d'autorisation suffisante.

Le code de résultat SQLITE_BUSY indique que le fichier de base de données n'a pas pu être écrit (ou dans certains cas lu) en raison de l'activité concurrente d'une autre connexion de base de données, habituellement une connexion de base de données dans un processus séparé. Par exemple, si le processus A est au milieu d'une transaction d'écriture importante et en même temps que le processus B tente de démarrer une nouvelle transaction d'écriture, le processus B récupérera un résultat SQLITE_BUSY parce que SQLite ne supporte qu'un auteur à la fois. Le processus B devra attendre que le processus A termine sa transaction avant de commencer une nouvelle transaction. Les interfaces sqlite3_busy_timeout() et sqlite3_busy_handler() et le pragma bloody_timeout sont disponibles pour traiter B pour l'aider à traiter les erreurs SQLITE_BUSY. Une erreur SQLITE_BUSY peut se produire à n'importe quel moment dans le cas. une transaction : lorsque la transaction est commencée, pendant toute opération d'écriture ou de mise à jour, ou lorsque la transaction est engagée. Pour éviter de rencontrer des erreurs SQLITE_BUSY au milieu d'une transaction, l'application peut utiliser BEGIN IMMEDIATE au lieu de seulement BEGIN pour démarrer une transaction. La commande BEGIN IMMEDIATE pourrait lui-même retourner SQLITE_BUSY, mais s'il réussit, SQLite garantit qu'aucune opération ultérieure sur la même base de données par le biais de la prochaine COMMIT ne retournera SQLITE_BUSY. Voir aussi : SQLITE_BUSY_RECOVERY et SQLITE_BUSY_SNAPSHOT. Le code de résultat SQLITE_BUSY diffère de SQLITE_LOCKED dans lequel SQLITE_BUSY indique un conflit avec une connexion séparée, probablement dans un processus séparé, tandis que SQLITE_L BOCKED indique un conflit dans la même connexion de base de données (ou parfois une connexion de base de données avec un cache partagé).

Le code d'erreur SQLITE_BUSY_RECOVERY est un code d'erreur étendu pour SQLITE_BUSY qui indique qu'une opération n'a pas pu se poursuivre parce qu'un autre processus est occupé à récupérer un fichier de base de données en mode WAL après un crash. Le code d'erreur SQLITE_BUSY_RECOVERY se trouve uniquement dans les bases de données en mode WAL.

Le code d'erreur SQLITE_BUSY_SNAPSHOT est un code d'erreur étendu pour SQLITE_BUSY qui se produit sur les bases de données en mode WAL lorsqu'une connexion à une base de données tente de promouvoir une transaction de lecture dans une transaction d'écriture mais constate qu'une autre connexion de base de données a déjà écrit dans la base de données et a ainsi invalidé les lectures antérieures. Le scénario suivant illustre comment une erreur SQLITE_BUSY_SNAPSHOT pourrait survenir :

Le code d'erreur SQLITE_BUSY_TIMEOUT indique qu'une requête de verrouillage de fichiers consultatifs Posix bloquant dans le calque VFS a échoué en raison d'un timeout. Les verrouillages de verrouillage Posix ne sont disponibles qu'en tant qu'extension propriétaire de SQLite et ne sont supportés que si SQLite est compilé avec l'option SQLITE_ENABLE_SETLK_TIMEOUT compil-time.

Le code de résultat SQLITE_CANTOPEN indique que SQLite n'a pas été en mesure d'ouvrir un fichier. Le fichier en question pourrait être un fichier de base de données primaire ou un de plusieurs fichiers de disque temporaires.

Le code d'erreur SQLITE_CANTOPEN_CONVPATH est un code d'erreur étendu pour SQLITE_CANTOPEN utilisé uniquement par Cygwin VFS et indiquant que l'appel système cygwin_conv_path() a échoué en essayant d'ouvrir un fichier. Voir aussi : SQLITE_IOERR_CONVPATH

Le code de résultat SQLITE_CANTOPEN_DIRTYWAL n'est pas utilisé pour le moment.

Le code d'erreur SQLITE_CANTOPEN_FULLPATH est un code d'erreur étendu pour SQLITE_CANTOPEN indiquant qu'une opération d'ouverture de fichier a échoué parce que le système d'exploitation n'a pas pu convertir le nom de fichier en un chemin complet.

Le code d'erreur SQLITE_CANTOPEN_ISDIR est un code d'erreur étendu pour SQLITE_CANTOPEN indiquant qu'une opération d'ouverture de fichier a échoué parce que le fichier est vraiment un répertoire.

Le code d'erreur SQLITE_CANTOPEN_NOTEMPDIR n'est plus utilisé.

Le code de résultat SQLITE_CANTOPEN_SYMLINK est retourné par l'interface sqlite3_open() et ses frères et sœurs lorsque le drapeau SQLITE_OPEN_NOFOLLOW est utilisé et que le fichier de base de données est un lien symbolique.

Le code d'erreur SQLITE_CONSTRAINT signifie qu'une violation de contrainte SQL s'est produite lors de l'essai de traiter une instruction SQL. Des informations supplémentaires sur la contrainte échouée peuvent être trouvées en consultant le message d'erreur (retourné via sqlite3_errmsg() ou sqlite3_errmsg16()) ou en regardant le code d'erreur étendu. Le code SQLITE_CONSTRAINT peut également être utilisé comme valeur de retour de la méthode xBestIndex() d'une implémentation de table virtuelle. Quand xBestIndex() retourne SQLITE_CONSTRAINT, cela indique que la combinaison particulière d'entrées soumises à xBestIndex() ne peut pas donner lieu à un plan de requête utilisable et ne devrait pas être pris en considération.

Le code d'erreur SQLITE_CONSTRAINT_CHECK est un code d'erreur étendu pour SQLITE_CONSTRAINT indiquant qu'une contrainte CHECK a échoué.

Le code d'erreur SQLITE_CONSTRAINT_COMMITHOOK est un code d'erreur étendu pour SQLITE_CONSTRAINT indiquant qu'un commit hook callback a retourné non-zéro qui a donc provoqué le renversement de l'instruction SQL.

Le code d'erreur SQLITE_CONSTRAINT_DATATYPE est un code d'erreur étendu pour SQLITE_CONSTRAINT indiquant qu'un insert ou une mise à jour a tenté de stocker une valeur incompatible avec le type déclaré de la colonne dans une table définie comme STRICT.

Le code d'erreur SQLITE_CONSTRAINT_FOREIGNKEY est un code d'erreur étendu pour SQLITE_CONSTRAINT indiquant qu'une contrainte de clé étrangère a échoué.

Le code d'erreur SQLITE_CONSTRAINT_FUNCTION n'est pas actuellement utilisé par le noyau SQLite. Cependant, ce code d'erreur est disponible pour les fonctions d'extension.

Le code d'erreur SQLITE_CONSTRAINT_NOTNULL est un code d'erreur étendu pour SQLITE_CONSTRAINT indiquant qu'une contrainte NOT NULL a échoué.

Le code d'erreur SQLITE_CONSTRAINT_PINNED est un code d'erreur étendu pour SQLITE_CONSTRAINT indiquant qu'un déclencheur UPDATE a tenté de supprimer la ligne qui était mise à jour au milieu de la mise à jour.

Le code d'erreur SQLITE_CONSTRAINT_PRIMARYKEY est un code d'erreur étendu pour SQLITE_CONSTRAINT indiquant qu'une contrainte PRIMARY KEY a échoué.

Le code d'erreur SQLITE_CONSTRAINT_ROWID est un code d'erreur étendu pour SQLITE_CONSTRAINT indiquant qu'une ligne n'est pas unique.

Le code d'erreur SQLITE_CONSTRAINT_TRIGGER est un code d'erreur étendu pour SQLITE_CONSTRAINT indiquant qu'une fonction RAISE au sein d'un déclencheur a été déclenchée, provoquant l'annulation de l'instruction SQL.

Le code d'erreur SQLITE_CONSTRAINT_UNIQUE est un code d'erreur étendu pour SQLITE_CONSTRAINT indiquant qu'une contrainte UNIQUE a échoué.

Le code d'erreur SQLITE_CONSTRAINT_VTAB n'est pas actuellement utilisé par le noyau SQLite. Cependant, ce code d'erreur est disponible pour être utilisé par des tables virtuelles définies par l'application.

Le code de résultat SQLITE_CORRUPT indique que le fichier de base de données a été corrompu. Consultez Comment corrompre vos fichiers de base de données pour une discussion plus approfondie sur la manière dont la corruption peut survenir.

Le code de résultat SQLITE_CORRUPT_INDEX signifie que SQLite a détecté une entrée ou était absent d'un index. Il s'agit d'un cas particulier du code d'erreur SQLITE_CORRUPT qui suggère que le problème pourrait être résolu en exécutant la commande REINDEX, en supposant qu'aucun autre problème n'existe ailleurs dans le fichier de base de données.

Le code de résultat SQLITE_CORRUPT_SEQUENCE signifie que le schéma de la table sqlite_séquence est corrompu. La table sqlite_sequence est utilisée pour aider à implémenter la fonction AUTOINCREMENT. La table sqlite_sequence devrait avoir le format suivant : Si SQLite découvre que la table sqlite_sequence a n'importe quel autre format, il retourne l'erreur SQLITE_CORRUPT_SEQUENCE.

Le code d'erreur SQLITE_CORRUPT_VTAB est un code d'erreur étendu pour SQLITE_CORRUPT utilisé par des tables virtuelles. Une table virtuelle pourrait retourner SQLITE_CORRUPT_VTAB pour indiquer que le contenu de la table virtuelle est corrompu.

Le code de résultat SQLITE_EMPTY n'est pas utilisé actuellement.

Le code de résultat SQLITE_ERROR est un code d'erreur générique utilisé lorsqu'il n'y a pas d'autre code d'erreur plus spécifique disponible.

Le code de résultat SQLITE_ERROR_MISSING_COLLSEQ signifie qu'une instruction SQL n'a pas pu être préparée parce qu'une séquence de collage nommée dans cette instruction SQL n'a pas pu être localisée. Parfois, lorsque ce code d'erreur est rencontré, la routine sqlite3_prepare_v2() convertira l'erreur en SQLITE_ERROR_RETRY et essayera à nouveau de préparer l'instruction SQL en utilisant un plan de requête différent qui ne nécessite pas l'utilisation de la séquence de collage inconnue.

Le SQLITE_ERROR_RETRY est utilisé en interne pour provoquer sqlite3_prepare_v2() (ou une de ses routines de création d'instructions préparées) pour essayer à nouveau de préparer une instruction qui a échoué avec une erreur sur la tentative précédente.

Le code de résultat SQLITE_ERROR_SNAPSHOT pourrait être retourné lorsque vous tentez de démarrer une transaction de lecture sur une version historique de la base de données en utilisant l'interface sqlite3_snapshot_open(). Si le snapshot historique n'est plus disponible, alors la transaction de lecture échouera avec SQLITE_ERROR_SNAPSHOT. Ce code d'erreur n'est possible que si SQLite est compilé avec -DSQLITE_ENAPSHOT.

Le code d'erreur SQLITE_FORMAT n'est pas actuellement utilisé par SQLite.

Le code de résultat SQLITE_FULL indique qu'une écriture n'a pas pu être terminée parce que le disque est plein. Notez que cette erreur peut se produire lorsque l'on essaye d'écrire des informations dans le fichier principal de la base de données, ou bien elle peut également se produire lors de l'écriture dans des fichiers de disque temporaires. Parfois, les applications rencontrent cette erreur même s'il y a une abondance d'espace disque primaire parce que l'erreur se produit lors de l'écriture dans des fichiers disques temporaires sur un système où les fichiers temporaires sont stockés sur une partition séparée avec beaucoup moins d'espace que le disque primaire.

Le code de résultat SQLITE_INTERNAL indique un dysfonctionnement interne. Dans une version de travail de SQLite, une application ne devrait jamais voir ce code de résultat. Si l'application rencontre ce code de résultat, il montre qu'il y a un bogue dans le moteur de base de données. Ce code de résultat pourrait être causé par un bogue dans SQLite. Cependant, les fonctions SQL ou tables virtuelles, ou VFSes, ou d'autres extensions peuvent également faire que ce code de résultat soit retourné, donc le problème pourrait ne pas être la faute du noyau SQLite.