Erreur MySQL 1062 : Entrée en double pour la clé
Un INSERT ou UPDATE insérerait une valeur déjà existante dans un index PRIMARY KEY ou UNIQUE. Le message indique la valeur et la clé.
- Numéro d'erreur
1062- Nom
ER_DUP_ENTRY- SQLSTATE
23000- Catégorie
- Clés et contraintes
Ce que cela signifie
MySQL rejette une ligne dont la valeur dans une clé primaire ou un index unique correspond à une ligne déjà existante. Le message affiche la valeur en double et l'index, par exemple Duplicate entry '[email protected]' for key 'users.email' (MySQL 8.0 et versions ultérieures incluent le nom de la table dans la clé).
Avec une insertion multi-lignes INSERT, les lignes avant le doublon sont conservées sur des tables non transactionnelles comme MyISAM, mais avec InnoDB, l'ensemble de l'instruction est annulé.
Causes courantes
- Réexécution d'un script d'import ou d'initialisation qui insère des lignes déjà présentes.
- Insertion d'un identifiant explicite qui existe déjà, ou d'un
AUTO_INCREMENTcompteur qui a été réglé en dessous du maximum actuel. - Une
UPDATEqui met une colonne unique à une valeur qu'une autre ligne possède. - Un index unique sur une colonne avec une collation insensible à la casse :
[email protected]et[email protected]comptent comme une même valeur.
Comment le corriger
-
Regardez la ligne qui contient déjà la valeur.
SELECT * FROM users WHERE email = '[email protected]';
-
Pour mettre plutôt à jour la ligne existante, utilisez
INSERT ... ON DUPLICATE KEY UPDATE. Sur MySQL 8.0.19 et les versions ultérieures, faites référence aux nouvelles valeurs via un alias de ligne ; les versions plus anciennes utilisentVALUES(name), qui fonctionne toujours mais est obsolète.INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') AS new ON DUPLICATE KEY UPDATE name = new.name; -
Pour ignorer intentionnellement les doublons, utilisez
INSERT IGNORE. Cela transforme l'erreur en avertissement, ainsi que certaines autres erreurs, donc vérifiezSHOW WARNINGSensuite.INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada'); -
Si le doublon concerne
AUTO_INCREMENT, vérifiez le compteur par rapport aux données.SELECT MAX(id) FROM users; SHOW CREATE TABLE users; -- shows AUTO_INCREMENT=n
Reproduisez-le en toute sécurité
CREATE TEMPORARY TABLE t (id INT PRIMARY KEY); INSERT INTO t VALUES (1); INSERT INTO t VALUES (1); -- ERROR 1062 (23000): Duplicate entry '1' for key 't.PRIMARY'
Questions
Comment puis-je savoir sur quelle clé se trouve le doublon ?
Le message le nomme : for key 'PRIMARY' est la clé primaire, tout le reste est le nom d'un index unique. SHOW INDEX FROM table_name; liste les index et leurs colonnes.
Erreurs liées
1452Échec de la clé étrangère : impossible d'ajouter la ligne enfant1048La colonne ne peut pas être nulle1586Entrée en double pour la clé (avec le nom de la clé)23505PostgreSQL : la clé en double viole la contrainte d'unicité2627SQL Server : violation de la contrainte PRIMARY KEY ou UNIQUE KEYORA-00001Oracle : contrainte unique violéeSQLITE_CONSTRAINT_UNIQUESQLite : échec de la contrainte UNIQUE
Plus d'erreurs de clés et de contraintes
1061Nom de clé en double1451Échec de la clé étrangère : impossible de supprimer la ligne parente1216Impossible d'ajouter ou de mettre à jour une ligne enfant1217Impossible de supprimer ou de mettre à jour une ligne parente1215Impossible d'ajouter une contrainte de clé étrangère3780Les colonnes de clé étrangère sont incompatibles1822Index manquant pour la contrainte de clé étrangère1824Échec de l'ouverture de la table référencée
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.
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.