Rechercher un code d’erreur

Le code d'erreur SQLITE_IOERR_SEEK est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans les méthodes xRead ou xWrite sur l'objet sqlite3_io_methods tout en essayant de rechercher un descripteur de fichier au point de début du fichier où la lecture ou l'écriture doit se produire.

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

Le code d'erreur SQLITE_IOERR_SHMMAP est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans la méthode xShmMap sur l'objet sqlite3_io_methods tout en essayant de mapper un segment de mémoire partagée dans l'espace d'adresse du processus.

Le code d'erreur SQLITE_IOERR_SHMOPEN est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans la méthode xShmMap sur l'objet sqlite3_io_methods tout en essayant d'ouvrir un nouveau segment de mémoire partagée.

Le code d'erreur SQLITE_IOERR_SHMSIZE est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans la méthode xShmMap sur l'objet sqlite3_io_methods tout en essayant d'agrandir un fichier "shm" dans le cadre du traitement des transactions en mode WAL. Cette erreur peut indiquer que le volume sous-jacent du système de fichiers est hors espace.

Le code d'erreur SQLITE_IOERR_SHORT_READ est un code d'erreur étendu pour SQLITE_IOERR indiquant qu'une tentative de lecture dans le calque VFS n'a pas été en mesure d'obtenir autant d'octets qu'il a été demandé. Cela pourrait être dû à un fichier trunqué.

Le code d'erreur SQLITE_IOERR_TRUNCATE est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans le calque VFS tout en essayant de modifier la taille d'un fichier en utilisant la méthode xTruncate de l'objet sqlite3_io_methods.

Le code d'erreur SQLITE_IOERR_UNLOCK est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans la méthode xUnlock sur l'objet sqlite3_io_methods.

Le code d'erreur SQLITE_IOERR_VNODE est un code réservé aux extensions. Il n'est pas utilisé par le noyau SQLite.

Le code d'erreur SQLITE_IOERR_WRITE est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans le calque VFS lors de l'écriture d'un fichier sur disque. Cette erreur pourrait résulter d'un dysfonctionnement matériel ou parce qu'un système de fichiers est devenu non monté pendant l'ouverture du fichier. Cette erreur ne devrait pas se produire si le système de fichiers est complet car il y a un code d'erreur séparé (SQLITE_FULL) à cette fin.

Le code de résultat SQLITE_LOCKED indique qu'une opération d'écriture ne peut pas se poursuivre à cause d'un conflit dans la même connexion de base de données ou d'un conflit avec une autre connexion de base de données qui utilise un cache partagé. Par exemple, une instruction DROP TABLE ne peut pas être exécutée alors qu'un autre thread est lu à partir de cette table sur la même connexion de base de données parce qu'en laissant tomber la table supprimerait la table sous le lecteur concurrent. Le code de résultat SQLITE_LOCKED diffère de SQLITE_BUSY dans ce cas SQLITE_LOCKED indique un conflit sur la même connexion de base de données (ou sur une connexion avec un cache partagé) tandis que SQLITE_BUSY indique un conflit avec une connexion de base de données différente, probablement dans un processus différent.

Le code de résultat SQLITE_LOCKED_SHAREDCACHE indique que l'accès à un enregistrement de données SQLite est bloqué par une autre connexion de base de données utilisant le même enregistrement en mode cache partagé. Lorsque deux ou plusieurs connexions de base de données partagent le même cache et qu'une des connexions est au milieu de modifier un enregistrement dans ce cache, alors d'autres connexions sont bloquées pour accéder à ces données pendant que les modifications sont en cours afin d'empêcher les lecteurs de voir un changement corrompu ou partiellement terminé.

Le code de résultat SQLITE_LOCKED_VTAB n'est pas utilisé par le noyau SQLite, mais il est disponible pour les extensions. Les implémentations de table virtuelle peuvent retourner ce code de résultat pour indiquer qu'ils ne peuvent pas terminer l'opération actuelle à cause des verrous détenus par d'autres threads ou processus. L'extension R-Tree retourne ce code de résultat lorsqu'une tentative est faite de mettre à jour le R-Tree alors qu'une autre instruction préparée est en train de lire activement le R-Tree. La mise à jour ne peut pas se faire parce qu'un changement à un R-Tree pourrait impliquer un remaniement et un rééquilibrage des noeuds, ce qui perturberait la lecture des curseurs, faisant répéter certaines lignes et omettre d'autres lignes.

Le code d'erreur SQLITE_MISMATTCH indique une erreur de type de données. SQLite est normalement très indulgent au sujet des inadéquations entre le type d'une valeur et le type déclaré du conteneur dans lequel cette valeur doit être stockée. Par exemple, SQLite permet à l'application de stocker une grande BLOB dans une colonne avec un type déclaré de BOOLEAN. Mais dans quelques cas, SQLite est stricte au sujet des types. L'erreur SQLITE_MISMATTCH est retournée dans ces rares cas lorsque les types ne correspondent pas. Le rangement d'une table doit être un entier. Tenter de définir le rangement d'un rangement d'une autre chose qu'un nombre d'ordres (ou un nombre NULL qui sera automatiquement converti dans le prochain rangement d'ordre disponible) donne des résultats dans une erreur SQLITE_MISMATTCH.

Le code de retour SQLITE_MISUSE peut être retourné si l'application utilise une interface SQLite d'une manière non définie ou non supportée. Par exemple, utiliser une déclaration préparée après que cette déclaration préparée a été finalisée pourrait entraîner une erreur SQLITE_MISUSE. SQLite essaie de détecter l'utilisation abusive et signaler l'utilisation abusive de ce code de résultat. Cependant, il n'y a aucune garantie que la détection de l'utilisation abusive sera réussie. La détection abusive est probabiliste. Les applications ne devraient jamais dépendre d'une valeur de retour SQLITE_MISUSE. Si SQLite retourne jamais SQLITE_MISUSE depuis une interface quelconque, cela signifie que l'application est incorrectement codée et doit être corrigée.

L'erreur SQLITE_NOLFS peut être retournée sur des systèmes qui ne prennent pas en charge de grands fichiers lorsque la base de données devient plus grande que ce que le système de fichiers peut gérer. "NOLFS" signifie "NO Large File Support".

Le code de résultat SQLITE_NOMEM indique que SQLite n'a pas été en mesure d'allouer toute la mémoire nécessaire pour terminer l'opération. En d'autres termes, un appel interne à sqlite3_malloc() ou sqlite3_realloc() a échoué dans un cas où la mémoire étant attribuée était nécessaire pour poursuivre l'opération.

Lorsque vous tentez d'ouvrir un fichier, l'erreur SQLITE_NOTADB indique que le fichier ouvert ne semble pas être un fichier de base de données SQLite.

Le code de résultat SQLITE_NOTFOUND est exposé de trois manières : Le code de résultat SQLITE_NOTFOUND est également utilisé en interne par l'implémentation SQLite, mais ces utilisations internes ne sont pas exposées à l'application.

Le code de résultat SQLITE_NOTICE n'est retourné par aucune interface C/C++. Cependant, SQLITE_NOTICE (ou plutôt l'un de ses codes d'erreur étendus) est parfois utilisé comme le premier argument dans un callback sqlite3_log() pour indiquer qu'une opération inhabituelle a lieu.

Le code de résultat SQLITE_NOTICE_RECOVER_ROLLBACK est passé au callback de sqlite3_log() lorsqu'un journal chaud est retourné.

Le code de résultat SQLITE_NOTICE_RECOVER_WAL est transmis au callback de sqlite3_log() lorsqu'un fichier de base de données en mode WAL est récupéré.

Le code de résultat SQLITE_PERM indique que le mode d'accès demandé pour une base de données nouvellement créée n'a pas pu être fourni.

Le code de résultat SQLITE_PROTOCOL indique un problème avec le protocole de verrouillage des fichiers utilisé par SQLite. L'erreur SQLITE_PROTOCOL n'est actuellement retournée qu'en utilisant le mode WAL et en essayant de démarrer une nouvelle transaction. Il y a une condition de course qui peut se produire lorsque deux connexions de base de données distinctes essayent de démarrer une transaction en même temps en mode WAL. Le perdant de la course recule et essaie de nouveau, après un bref retard. Si la même connexion perd la course de verrouillage des dizaines de fois sur une période de plusieurs secondes, il finira par abandonner et retourner SQLITE_PROTOCOL. L'erreur SQLITE_PROTOCOL devrait apparaître en pratique très rarement, et seulement lorsqu'il y a beaucoup de processus séparés qui rivalisent intensément pour écrire sur la même base de données.

Les indices d'erreur SQLITE_RANGE indiquent que l'argument du nombre de paramètres pour une routine sqlite3_bind ou le nombre de colonne dans une routine sqlite3_colonne est hors de portée.

Le code de résultat SQLITE_READONLY est retourné lorsqu'une tentative est faite pour modifier certaines données pour lesquelles la connexion de base de données actuelle n'a pas la permission d'écriture.

Le code de résultat SQLITE_READONLY_CANTINIT provient de la méthode xShmMap d'un VFS pour indiquer que la région mémoire partagée utilisée par le mode WAL existe mais que son contenu n'est pas fiable et inutilisable par le processus actuel puisque le processus actuel n'a pas d'autorisation d'écriture sur la région mémoire partagée. (La région mémoire partagée pour le mode WAL est normalement un fichier avec un suffixe "-wal" qui est mmappé dans l'espace de processus. Si le processus actuel n'a pas d'autorisation d'écriture sur ce fichier, alors il ne peut pas écrire dans la mémoire partagée.) La logique de niveau supérieur dans SQLite interceptera normalement le code d'erreur et créera une région mémoire partagée temporaire dans la mémoire afin que le processus actuel puisse au moins lire le contenu de la base de données. Ce code de résultat ne devrait pas atteindre la couche d'interface de l'application.

Le code d'erreur SQLITE_READONLY_CANTLOCK est un code d'erreur étendu pour SQLITE_READONLY. Le code d'erreur SQLITE_READONLY_CANTLOCK indique que SQLite n'est pas en mesure d'obtenir un verrou sur une base de données en mode WAL parce que le fichier mémoire partagée associé à cette base de données est en lecture seule.

Le code d'erreur SQLITE_READONLY_DBMOVED est un code d'erreur étendu pour SQLITE_READONLY. Le code d'erreur SQLITE_READONLY_DBMOVED indique qu'une base de données ne peut pas être modifiée parce que le fichier de base de données a été déplacé depuis qu'il a été ouvert, et donc toute tentative de modifier la base de données pourrait entraîner une corruption de la base de données si les processus s'effondrent parce que le journal de renversement ne serait pas correctement nommé.

Le code de résultat SQLITE_READONLY_DIRECTORY indique que la base de données est en lecture seule parce que le processus n'a pas la permission de créer un fichier journal dans le même répertoire que la base de données et la création d'un fichier journal est une condition préalable à l'écriture.

Le code d'erreur SQLITE_READONLY_RECOVERY est un code d'erreur étendu pour SQLITE_READONLY. Le code d'erreur SQLITE_READONLY_RECOVERY indique qu'une base de données en mode WAL ne peut pas être ouverte parce que le fichier de base de données doit être récupéré et la récupération nécessite l'accès à l'écriture, mais seulement l'accès à la lecture est disponible.

Le code d'erreur SQLITE_READONLY_ROLLBACK est un code d'erreur étendu pour SQLITE_READONLY. Le code d'erreur SQLITE_READONLY_ROLLBACK indique qu'une base de données ne peut pas être ouverte parce qu'elle a un journal chaud qui doit être roulé en arrière mais ne peut pas parce que la base de données est en lecture seule.

Le code de résultat SQLITE_SCHEMA indique que le schéma de base de données a changé. Ce code de résultat peut être retourné de sqlite3_step() pour une instruction préparée qui a été générée à l'aide de sqlite3_prepare() ou sqlite3_prepare16(). Si le schéma de base de données a été modifié par un autre processus entre le moment où l'instruction a été préparée et le moment où l'instruction a été exécutée, cette erreur peut résulter. Si une instruction préparée est générée à partir de sqlite3_prepare_v2() alors l'instruction est automatiquement ré-préparée si le schéma change, jusqu'à SQLITE_MAX_SCHEMA_RETRY temps (par défaut : 50). L'interface sqlite3_step() ne retournera à l'application que si l'échec persiste après cette fois de ret. Des riz.

Le code d'erreur SQLITE_TOOBIG indique qu'une chaîne ou BLOB était trop grande. La longueur maximale par défaut d'une chaîne ou BLOB dans SQLite est de 1 000 000 000 octets. Cette longueur maximale peut être modifiée au moment de la compilation en utilisant l'option SQLITE_MAX_LENGTH de compilation ou au moment de l'exécution en utilisant l'interface sqlite3_limit(db,SQLITE_LIMIT_LENGTH,...). L'erreur SQLITE_TOOBIG résulte lorsque SQLite rencontre une chaîne ou BLOB qui dépasse la durée de compilation ou la limite d'exécution. Le code d'erreur SQLITE_TOOBIG peut aussi résulter lorsqu'une instruction SQL est transmise dans une des interfaces sqlite3_prepare_v2(). La longueur maximale d'une instruction SQL est par défaut à une valeur similaire La longueur maximale de l'instruction SQL peut être définie au moment de la compilation en utilisant SQLITE_MAX_SQL_LENGTH ou au moment de l'exécution en utilisant sqlite3_limit(db,SQLITE_LIMIT_SQL_LENGTH,...).

Le code de résultat SQLITE_WARNING n'est retourné par aucune interface C/C++. Cependant, SQLITE_WARNING (ou plutôt l'un de ses codes d'erreurs étendus) est parfois utilisé comme premier argument dans un callback sqlite3_log() pour indiquer qu'une opération inhabituelle et éventuellement mal avisée a lieu.

Le code de résultat SQLITE_WARNING_AUTOINDEX est passé à la callback de sqlite3_log() chaque fois que l'indexation automatique est utilisée. Cela peut servir d'avertissement aux concepteurs d'applications que la base de données pourrait bénéficier d'index supplémentaires.