// référence des erreurs

Codes d'erreur SQLite

Tous les codes de résultat SQLite de la liste officielle, principaux et étendus, avec le texte sqlite3_errstr() retourne pour chaque code primaire. Ceux que vous êtes susceptible de rencontrer ont une page complète avec les causes et les solutions.

Lire une erreur SQLite

Les fonctions SQLite retournent un code de résultat entier. Les huit bits faibles sont le code primaire, tel que SQLITE_BUSY (5). Les codes étendus ajoutent des détails dans les bits supérieurs : SQLITE_BUSY_SNAPSHOT est 517, soit 5 + 2 × 256. Les codes étendus sont renvoyés lorsqu'ils sont activés avec sqlite3_extended_result_codes() ou lus avec sqlite3_extended_errcode().

Le message qu'un programme affiche provient généralement de sqlite3_errmsg(), qui peut être plus spécifique que le texte générique, par exemple UNIQUE constraint failed: users.email au lieu de constraint failed.

Les bindings de langage encapsulent ces codes : celui de Python sqlite3 lève OperationalError ou IntegrityError et, depuis Python 3.11, expose sqlite_errorcode et sqlite_errorname sur l'exception.

Toutes les erreurs SQLite dans cette référence

105 codes, 40 avec une explication complète (lien). Les codes et messages proviennent de la documentation des codes de résultat et d'erreur SQLite.

Codes de résultat principaux

CodeSens
SQLITE_OK 0 pas une erreur
SQLITE_ERROR Erreur de logique SQL 1 Erreur de logique SQL
SQLITE_INTERNAL 2
SQLITE_PERM permission d’accès refusée 3 permission d’accès refusée
SQLITE_ABORT requête avortée 4 requête avortée
SQLITE_BUSY la base de données est verrouillée 5 la base de données est verrouillée
SQLITE_LOCKED la table de la base de données est verrouillée 6 la table de la base de données est verrouillée
SQLITE_NOMEM Manque de mémoire 7 Manque de mémoire
SQLITE_READONLY tentative d'écriture dans une base de données en lecture seule 8 tentative d'écriture dans une base de données en lecture seule
SQLITE_INTERRUPT interrompu 9 interrompu
SQLITE_IOERR erreur d'E/S disque 10 erreur d'E/S disque
SQLITE_CORRUPT l'image disque de la base de données est corrompue 11 l'image disque de la base de données est corrompue
SQLITE_NOTFOUND 12 opération inconnue
SQLITE_FULL la base de données ou le disque est plein 13 la base de données ou le disque est plein
SQLITE_CANTOPEN impossible d'ouvrir le fichier de base de données 14 impossible d'ouvrir le fichier de base de données
SQLITE_PROTOCOL protocole de verrouillage 15 protocole de verrouillage
SQLITE_EMPTY 16
SQLITE_SCHEMA le schéma de la base de données a changé 17 le schéma de la base de données a changé
SQLITE_TOOBIG chaîne ou blob trop grand 18 chaîne ou blob trop grand
SQLITE_CONSTRAINT échec de contrainte 19 échec de contrainte
SQLITE_MISMATCH incompatibilité de type de données 20 incompatibilité de type de données
SQLITE_MISUSE paramètre incorrect ou autre mauvaise utilisation de l'API 21 paramètre incorrect ou autre mauvaise utilisation de l'API
SQLITE_NOLFS 22
SQLITE_AUTH autorisation refusée 23 autorisation refusée
SQLITE_FORMAT 24
SQLITE_RANGE indice de colonne hors plage 25 indice de colonne hors plage
SQLITE_NOTADB le fichier n'est pas une base de données 26 le fichier n'est pas une base de données
SQLITE_NOTICE 27 message de notification
SQLITE_WARNING 28 message d'avertissement
SQLITE_ROW 100 autre ligne disponible
SQLITE_DONE 101 plus de lignes disponibles

Codes de résultat étendus

CodeSens
SQLITE_OK_LOAD_PERMANENTLY 256
SQLITE_ERROR_MISSING_COLLSEQ aucune séquence de tri de ce type 257 aucune séquence de tri de ce type : unicode_ci
SQLITE_BUSY_RECOVERY un autre processus est en train de récupérer le WAL 261 la base de données est verrouillée
SQLITE_LOCKED_SHAREDCACHE enregistrement verrouillé dans le cache partagé 262 la table de la base de données est verrouillée
SQLITE_READONLY_RECOVERY 264
SQLITE_IOERR_READ 266
SQLITE_CORRUPT_VTAB 267
SQLITE_CANTOPEN_NOTEMPDIR 270
SQLITE_CONSTRAINT_CHECK contrainte CHECK échouée 275 contrainte CHECK échouée : price_positive
SQLITE_AUTH_USER 279
SQLITE_NOTICE_RECOVER_WAL 283
SQLITE_WARNING_AUTOINDEX 284
SQLITE_ERROR_RETRY 513
SQLITE_ABORT_ROLLBACK instruction annulée par ROLLBACK 516 abandon dû à ROLLBACK
SQLITE_BUSY_SNAPSHOT lecture obsolète ne peut pas devenir une écriture 517 la base de données est verrouillée
SQLITE_LOCKED_VTAB 518
SQLITE_READONLY_CANTLOCK 520
SQLITE_IOERR_SHORT_READ lecture a renvoyé moins d’octets 522 erreur d'E/S disque
SQLITE_CORRUPT_SEQUENCE 523
SQLITE_CANTOPEN_ISDIR le chemin est un répertoire 526 impossible d'ouvrir le fichier de base de données
SQLITE_CONSTRAINT_COMMITHOOK 531
SQLITE_NOTICE_RECOVER_ROLLBACK 539
SQLITE_ERROR_SNAPSHOT 769
SQLITE_BUSY_TIMEOUT expiration du verrou de fichier bloquant 773 la base de données est verrouillée
SQLITE_READONLY_ROLLBACK le journal à chaud ne peut pas être restauré 776 tentative d'écriture dans une base de données en lecture seule
SQLITE_IOERR_WRITE 778
SQLITE_CORRUPT_INDEX entrée d'index manquante 779 l'image disque de la base de données est corrompue
SQLITE_CANTOPEN_FULLPATH 782
SQLITE_CONSTRAINT_FOREIGNKEY Échec de la contrainte de clé étrangère 787 Échec de la contrainte de clé étrangère
SQLITE_READONLY_DBMOVED fichier de base de données déplacé pendant qu'il était ouvert 1032 tentative d'écriture dans une base de données en lecture seule
SQLITE_IOERR_FSYNC 1034
SQLITE_CANTOPEN_CONVPATH 1038
SQLITE_CONSTRAINT_FUNCTION 1043
SQLITE_READONLY_CANTINIT 1288
SQLITE_IOERR_DIR_FSYNC 1290
SQLITE_CANTOPEN_DIRTYWAL 1294
SQLITE_CONSTRAINT_NOTNULL Échec de la contrainte NOT NULL 1299 Échec de la contrainte NOT NULL : users.name
SQLITE_READONLY_DIRECTORY impossible de créer le fichier journal 1544 tentative d'écriture dans une base de données en lecture seule
SQLITE_IOERR_TRUNCATE 1546
SQLITE_CONSTRAINT_PRIMARYKEY Échec de la contrainte de clé primaire 1555 Violation de la contrainte UNIQUE : orders.id
SQLITE_IOERR_FSTAT 1802
SQLITE_CONSTRAINT_TRIGGER RAISE() dans un déclencheur l'a interrompu 1811 échec de contrainte
SQLITE_IOERR_UNLOCK 2058
SQLITE_CONSTRAINT_UNIQUE Violation de la contrainte UNIQUE 2067 Violation de la contrainte UNIQUE : users.email
SQLITE_IOERR_RDLOCK 2314
SQLITE_CONSTRAINT_VTAB 2323
SQLITE_IOERR_DELETE 2570
SQLITE_CONSTRAINT_ROWID 2579
SQLITE_IOERR_BLOCKED 2826
SQLITE_CONSTRAINT_PINNED 2835
SQLITE_IOERR_NOMEM 3082
SQLITE_CONSTRAINT_DATATYPE la valeur ne correspond pas à une colonne STRICT 3091 impossible de stocker une valeur TEXT dans la colonne INTEGER t.qty
SQLITE_IOERR_ACCESS 3338
SQLITE_IOERR_CHECKRESERVEDLOCK 3594
SQLITE_IOERR_LOCK 3850
SQLITE_IOERR_CLOSE 4106
SQLITE_IOERR_DIR_CLOSE 4362
SQLITE_IOERR_SHMOPEN 4618
SQLITE_IOERR_SHMSIZE 4874
SQLITE_IOERR_SHMLOCK 5130
SQLITE_IOERR_SHMMAP 5386
SQLITE_IOERR_SEEK 5642
SQLITE_IOERR_DELETE_NOENT 5898
SQLITE_IOERR_MMAP 6154
SQLITE_IOERR_GETTEMPPATH 6410
SQLITE_IOERR_CONVPATH 6666
SQLITE_IOERR_VNODE 6922
SQLITE_IOERR_AUTH 7178
SQLITE_IOERR_BEGIN_ATOMIC 7434
SQLITE_IOERR_COMMIT_ATOMIC 7690
SQLITE_IOERR_ROLLBACK_ATOMIC 7946
SQLITE_IOERR_DATA 8202
SQLITE_IOERR_CORRUPTFS 8458
// un client, tous les moteurs

Une façon plus rapide de travailler avec SQLite

SQLly est un client SQL natif pour macOS, Windows et Linux, avec un IntelliSense conscient du schéma et des garde-fous contre les instructions risquées.