// Référence des erreurs MySQL

Erreur MySQL 1215 : Impossible d'ajouter une contrainte de clé étrangère

MySQL a rejeté une définition de FOREIGN KEY : les types de colonnes diffèrent, le parent n'est pas indexé, ou le moteur de la table ne supporte pas les clés étrangères.

Numéro d'erreur
1215
Nom
ER_CANNOT_ADD_FOREIGN
SQLSTATE
HY000
Catégorie
Clés et contraintes
Message d'erreur
Cannot add foreign key constraint

Ce que cela signifie

1215 indique que la clé étrangère n'a pas pu être créée mais pas pourquoi. MySQL 8.0 rapporte souvent une erreur plus spécifique à la place (3780 pour des colonnes incompatibles, 1822 pour un index parent manquant, 1824 pour une table parent manquante). Pour les détails, exécutez SHOW ENGINE INNODB STATUS et lisez la LATEST FOREIGN KEY ERROR section.

Causes courantes

  • Les colonnes enfant et parent ont des types différents, un signe (signé/non signé) différent (INT contre INT UNSIGNED), une longueur, ou un jeu de caractères et un interclassement différents.
  • Les colonnes référencées ne constituent pas une clé primaire, ou ne forment pas le début d'un index.
  • Une des tables utilise MyISAM ou un autre moteur sans support des clés étrangères.
  • La table parente n'existe pas encore lorsque l'enfant est créé.
  • ON DELETE SET NULL sur une colonne déclarée NOT NULL.

Comment le corriger

  1. Lisez la raison détaillée.

    SHOW ENGINE INNODB STATUS;  -- LATEST FOREIGN KEY ERROR
  2. Comparez les définitions des colonnes des deux côtés et rendez-les identiques.

    SHOW CREATE TABLE customers;
    SHOW CREATE TABLE orders;
  3. Faites correspondre les types de colonnes, puis ajoutez la clé.

    ALTER TABLE orders MODIFY customer_id INT UNSIGNED NOT NULL;
    ALTER TABLE orders ADD CONSTRAINT fk_orders_customer
      FOREIGN KEY (customer_id) REFERENCES customers (id);
  4. Convertissez les tables MyISAM en InnoDB.

    ALTER TABLE customers ENGINE = InnoDB;

Erreurs liées

Plus d'erreurs de clés et de contraintes

Le code et le texte du message sont issus de Référence des messages d'erreur MySQL 8.4. Parcourir la liste complète Liste des erreurs MySQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur MySQL 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 MySQL et les autres bases de données que vous utilisez.