SQLITE_CONSTRAINT_FOREIGNKEY : échec de la contrainte de clé étrangère
Une écriture laisserait une ligne enfant pointant vers un parent qui n'existe pas, ou supprimerait un parent qui a encore des enfants. Les clés étrangères doivent être activées pour chaque connexion.
- Code de résultat
SQLITE_CONSTRAINT_FOREIGNKEY- Nom
787- Catégorie
- Codes de résultat étendus
Ce que cela signifie
SQLITE_CONSTRAINT_FOREIGNKEY (787) signifie qu'une vérification de clé étrangère a échoué. SQLite n'applique les clés étrangères que sur les connexions qui exécutent PRAGMA foreign_keys = ON; elles sont désactivées par défaut pour des raisons de compatibilité ascendante, c'est pourquoi la même insertion peut réussir dans un outil et échouer dans un autre.
Le message ne précise pas quelle clé a échoué. PRAGMA foreign_key_check liste chaque ligne en infraction.
Causes courantes
- Insertion d'une ligne enfant dont l'identifiant du parent n'existe pas.
- Suppression ou mise à jour d'une ligne parent qui a encore des enfants, sans
ON DELETE CASCADEouSET NULL. - Chargement des tables dans le mauvais ordre : enfants avant parents.
- Contraintes différées (
DEFERRABLE INITIALLY DEFERRED) échouant àCOMMIT.
Comment le corriger
-
Trouvez les lignes qui violent une clé étrangère.
PRAGMA foreign_key_check; PRAGMA foreign_key_list(orders);
-
Insérer les parents avant les enfants, ou supprimer les enfants avant les parents.
-
Pour les chargements massifs, différez la vérification jusqu'à la fin de la transaction.
BEGIN; PRAGMA defer_foreign_keys = ON; -- load tables in any order COMMIT;
-
Si la suppression d'un parent doit supprimer ses enfants, déclarez l'action sur la clé étrangère.
CREATE TABLE orders ( id INTEGER PRIMARY KEY, customer_id INTEGER NOT NULL REFERENCES customers(id) ON DELETE CASCADE );
Reproduisez-le en toute sécurité
PRAGMA foreign_keys = ON; CREATE TABLE p (id INTEGER PRIMARY KEY); CREATE TABLE c (pid INTEGER REFERENCES p(id)); INSERT INTO c VALUES (1); -- Runtime error: FOREIGN KEY constraint failed (19)
Questions
Pourquoi les clés étrangères ne sont-elles pas appliquées dans ma base de données SQLite ?
La contrainte s'applique par connexion et est désactivée par défaut. Chaque connexion doit exécuter PRAGMA foreign_keys = ON, et ce réglage ne peut pas être modifié à l'intérieur d'une transaction.
Erreurs liées
SQLITE_CONSTRAINTéchec de contrainte23503PostgreSQL : violation de contrainte de clé étrangère1452MySQL : Échec de la clé étrangère : impossible d'ajouter la ligne enfant1451MySQL : Échec de la clé étrangère : impossible de supprimer la ligne parente547SQL Server : instruction en conflit avec une contrainteORA-02291Oracle : contrainte d'intégrité violée - aucune clé parenteORA-02292Oracle : contrainte d'intégrité violée - enregistrement enfant trouvé
Plus de codes d'erreurs de résultat étendus
SQLITE_ERROR_MISSING_COLLSEQaucune séquence de tri de ce typeSQLITE_BUSY_RECOVERYun autre processus est en train de récupérer le WALSQLITE_LOCKED_SHAREDCACHEenregistrement verrouillé dans le cache partagéSQLITE_CONSTRAINT_CHECKcontrainte CHECK échouéeSQLITE_ABORT_ROLLBACKinstruction annulée par ROLLBACKSQLITE_BUSY_SNAPSHOTlecture obsolète ne peut pas devenir une écritureSQLITE_IOERR_SHORT_READlecture a renvoyé moins d’octetsSQLITE_CANTOPEN_ISDIRle chemin est un répertoire
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.