SQLITE_CONSTRAINT : échec de contrainte
Une instruction INSERT ou UPDATE a enfreint une contrainte : UNIQUE, PRIMARY KEY, NOT NULL, CHECK ou FOREIGN KEY. Le message et le code étendu indiquent laquelle.
- Code de résultat
SQLITE_CONSTRAINT- Nom
19- Catégorie
- Codes de résultat principaux
Ce que cela signifie
SQLITE_CONSTRAINT (19) signifie qu'une instruction aurait enfreint l'une des règles de la table, donc SQLite l'a arrêtée. Le texte générique est constraint failed, mais le message nomme habituellement la règle et la colonne, comme UNIQUE constraint failed: users.email, et le code étendu vous indique le type : SQLITE_CONSTRAINT_UNIQUE, _PRIMARYKEY, _NOTNULL, _CHECK, _FOREIGNKEY, _DATATYPE (tables STRICT) ou _TRIGGER (un RAISE() dans un déclencheur).
Par défaut, l’instruction en échec est annulée (mode de conflit ABORT) mais les instructions précédentes dans la même transaction sont conservées.
Causes courantes
- Une valeur en double dans une clé primaire ou une colonne unique.
- Un NULL dans une colonne
NOT NULL, souvent parce que l'insertion a laissé la colonne vide et qu'elle n'a pas de valeur par défaut. - Une valeur qui échoue à une
CHECKexpression. - Une ligne enfant dont le parent n'existe pas, avec
PRAGMA foreign_keys = ON. - Une valeur d'un type incorrect dans une
STRICTtable.
Comment le corriger
-
Lisez le message ou le code étendu pour voir quelle contrainte a échoué, puis consultez la définition de la table.
SELECT sql FROM sqlite_schema WHERE name = 'users';
-
Pour les doublons que vous voulez fusionner ou ignorer, utilisez un upsert ou une clause de conflit.
INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = excluded.name; -
Pour les autres contraintes, corrigez les données que vous écrivez : fournissez la valeur manquante, insérez d'abord la ligne parent, ou corrigez la valeur qui échoue au contrôle.
Erreurs liées
SQLITE_CONSTRAINT_UNIQUEViolation de la contrainte UNIQUESQLITE_CONSTRAINT_PRIMARYKEYÉchec de la contrainte de clé primaireSQLITE_CONSTRAINT_NOTNULLÉchec de la contrainte NOT NULLSQLITE_CONSTRAINT_CHECKcontrainte CHECK échouéeSQLITE_CONSTRAINT_FOREIGNKEYÉchec de la contrainte de clé étrangèreSQLITE_CONSTRAINT_DATATYPEla valeur ne correspond pas à une colonne STRICT
Plus d'erreurs de codes de résultat principaux
SQLITE_ERRORErreur de logique SQLSQLITE_PERMpermission d’accès refuséeSQLITE_ABORTrequête avortéeSQLITE_BUSYla base de données est verrouilléeSQLITE_LOCKEDla table de la base de données est verrouilléeSQLITE_NOMEMManque de mémoireSQLITE_READONLYtentative d'écriture dans une base de données en lecture seuleSQLITE_INTERRUPTinterrompu
Le code et le texte du message sont issus de documentation des codes de résultat et d'erreur SQLite. Parcourir la liste complète Liste des erreurs SQLite ou Rechercher toutes les erreurs de base de données.
Travailler sur SQLite dans SQLly
Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour SQLite et les autres bases de données que vous utilisez.