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
| Code | Sens |
|---|---|
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
| Code | Sens |
|---|---|
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_CANTOPEN_SYMLINK
|
1550
|
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
|
Autres bases de données
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.