// Référence des erreurs SQLite

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
Message d'erreur
FOREIGN KEY constraint failed

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 CASCADE ou SET NULL.
  • Chargement des tables dans le mauvais ordre : enfants avant parents.
  • Contraintes différées (DEFERRABLE INITIALLY DEFERRED) échouant à COMMIT.

Comment le corriger

  1. Trouvez les lignes qui violent une clé étrangère.

    PRAGMA foreign_key_check;
    PRAGMA foreign_key_list(orders);
  2. Insérer les parents avant les enfants, ou supprimer les enfants avant les parents.

  3. 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;
  4. 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

Plus de codes d'erreurs de résultat étendus

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.

// moins d'erreurs, corrections plus rapides

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.