SQLite : codes d’erreur

Le code de résultat SQLITE_INTERRUPT indique qu'une opération a été interrompue par l'interface sqlite3_interrupt(). Voir aussi : SQLITE_ABORT

Le code de résultat SQLITE_IOERR indique que l'opération n'a pas pu se terminer parce que le système d'exploitation a signalé une erreur d'E/S. Un disque complet donnera normalement une erreur SQLITE_FULL plutôt qu'une erreur SQLITE_IOERR. Il existe de nombreux codes de résultat étendus pour les erreurs d'E/S qui identifient l'opération d'E/S spécifique qui a échoué.

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

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

Le code d'erreur SQLITE_IOERR_BEGIN_ATOMIC indique que le système d'exploitation sous-jacent a signalé une erreur sur le contrôle de fichier SQLITE_FCNTL_BEGIN_ATOMIC_WRITE. Cela n'apparaît que lorsque SQLITE_ENABLE_ATOMIC_WRITE est activé et que la base de données est hébergée sur un système de fichiers supportant les écrits atomiques.

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

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

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

Le code d'erreur SQLITE_IOERR_COMMIT_ATOMIC indique que le système d'exploitation sous-jacent a signalé une erreur sur le contrôle de fichier SQLITE_FCNTL_COMMIT_ATOMIC_WRITE. Cela n'apparaît que lorsque SQLITE_ENABLE_ATOMIC_WRITE est activé et que la base de données est hébergée sur un système de fichiers qui supporte les écrits atomiques.

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

Le code d'erreur SQLITE_IOERR_CORRUPTFS est un code d'erreur étendu pour SQLITE_IOERR utilisé uniquement par un VFS pour indiquer qu'un échec de recherche ou de lecture était dû à la requête ne relevant pas de la limite du fichier plutôt qu'à une défaillance du périphérique ordinaire. Cela indique souvent un système de fichiers corrompu.

Le code d'erreur SQLITE_IOERR_DATA est un code d'erreur étendu pour SQLITE_IOERR utilisé uniquement par le checksum VFS Shim pour indiquer que le checksum sur une page du fichier de base de données est incorrect.

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

Le code d'erreur SQLITE_IOERR_DELETE_NOENT est un code d'erreur étendu pour SQLITE_IOERR indiquant que la méthode xDelete sur l'objet sqlite3_vfs a échoué parce que le fichier supprimé n'existe pas.

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

Le code d'erreur SQLITE_IOERR_DIR_FSYNC est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans le calque VFS tout en essayant d'invoquer fsync() sur un répertoire. L'unix VFS tente de créer ou de supprimer certains fichiers pour s'assurer que ces fichiers apparaissent toujours dans le système de fichiers après une perte de puissance ou un crash du système. Ce code d'erreur indique un problème d'exécution de fsync().

Le code d'erreur SQLITE_IOERR_FSTAT est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans la couche VFS tout en essayant d'invoquer fstat() (ou l'équivalent) sur un fichier afin de déterminer des informations telles que la taille du fichier ou les permissions d'accès.

Le code d'erreur SQLITE_IOERR_FSYNC est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans le calque VFS tout en essayant d'effacer le contenu précédemment écrit des tampons OS et/ou de contrôle de disque et dans le stockage persistant. En d'autres termes, ce code indique un problème avec l'appel système fsync() dans unix ou l'appel système FlushFileBuffers() dans les fenêtres.

Le code d'erreur SQLITE_IOERR_GETTEMPPATH est un code d'erreur étendu pour SQLITE_IOERR indiquant que le VFS n'est pas en mesure de déterminer un répertoire approprié dans lequel placer des fichiers temporaires.

Le code d'erreur SQLITE_IOERR_LOCK est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans la logique de verrouillage du fichier consultatif. Habituellement, une erreur SQLITE_IOERR_LOCK indique un problème d'obtention d'un verrouillage PENDING. Cependant, il peut également indiquer des erreurs de verrouillage diverses sur certains des VFS spécialisés utilisés sur Macs.

Le code d'erreur SQLITE_IOERR_MMAP est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans les méthodes xFetch ou xUnfetch sur l'objet sqlite3_io_methods tout en essayant de mapper ou de démapper une partie du fichier de base de données dans l'espace d'adresse du processus.

Le code d'erreur SQLITE_IOERR_NOMEM est parfois retourné par le calque VFS pour indiquer qu'une opération n'a pas pu être complétée en raison de l'incapacité d'allouer une mémoire suffisante. Ce code d'erreur est normalement converti en SQLITE_NOMEM par les calques supérieurs de SQLite avant d'être retourné à l'application.

Le code d'erreur SQLITE_IOERR_RDLOCK est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans la méthode xLock sur l'objet sqlite3_io_methods tout en essayant d'obtenir un verrouillage de lecture.

Le code d'erreur SQLITE_IOERR_READ est un code d'erreur étendu pour SQLITE_IOERR indiquant une erreur d'E/S dans le calque VFS en essayant de lire à partir 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 démonté pendant que le fichier était ouvert.

Le code d'erreur SQLITE_IOERR_ROLLBACK_ATOMIC indique que le système d'exploitation sous-jacent a signalé une erreur sur SQLITE_FCNTL_ROLLBACK_ATOMIC_WRITE. Cela n'apparaît que lorsque SQLITE_ENABLE_ATOMIC_WRITE est activé et que la base de données est hébergée sur un système de fichiers supportant les écrits atomiques.

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.