MySQL-Fehler 1062: Doppelter Eintrag für Schlüssel
Ein INSERT oder UPDATE würde einen Wert einfügen, der bereits in einem PRIMARY KEY oder UNIQUE-Index existiert. Die Meldung nennt den Wert und den Schlüssel.
- Fehlernummer
1062- Name
ER_DUP_ENTRY- SQLSTATE
23000- Kategorie
- Schlüssel und Constraints
Was es bedeutet
MySQL lehnt eine Zeile ab, deren Wert in einem Primärschlüssel oder eindeutigen Index mit einer bereits existierenden Zeile übereinstimmt. Die Meldung zeigt den doppelten Wert und den Index, zum Beispiel Duplicate entry '[email protected]' for key 'users.email' (MySQL 8.0 und höher nehmen den Tabellennamen in den Schlüssel auf).
Bei einer Mehrzeilen- INSERTwerden die Zeilen vor dem Duplikat in nicht-transaktionalen Tabellen wie MyISAM beibehalten, aber bei InnoDB wird die gesamte Anweisung zurückgesetzt.
Häufige Ursachen
- Erneutes Ausführen eines Import- oder Seed-Skripts, das Zeilen einfügt, die schon vorhanden sind.
- Einfügen einer expliziten ID, die bereits existiert, oder ein
AUTO_INCREMENTZähler, der unter dem aktuellen Maximum gesetzt wurde. - Eine
UPDATE, der eine eindeutige Spalte in einen Wert ändert, den eine andere Zeile hat. - Ein eindeutiger Index auf einer Spalte mit einer Kollation, die Groß- und Kleinschreibung nicht unterscheidet:
[email protected]und[email protected]wird als derselbe Wert gezählt.
Wie du es behebst
-
Sieh dir die Zeile an, die den Wert bereits enthält.
SELECT * FROM users WHERE email = '[email protected]';
-
Um stattdessen die vorhandene Zeile zu aktualisieren, verwende
INSERT ... ON DUPLICATE KEY UPDATE. In MySQL 8.0.19 und höher greifst du über einen Zeilen-Alias auf die neuen Werte zu; ältere Versionen verwendenVALUES(name), was immer noch funktioniert, aber veraltet ist.INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') AS new ON DUPLICATE KEY UPDATE name = new.name; -
Um Duplikate absichtlich zu überspringen, verwende
INSERT IGNORE. Es macht aus dem Fehler eine Warnung, zusammen mit einigen anderen Fehlern, prüfe alsoSHOW WARNINGSdanach.INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada'); -
Wenn das Duplikat auf
AUTO_INCREMENT, gleiche den Zähler mit den Daten ab.SELECT MAX(id) FROM users; SHOW CREATE TABLE users; -- shows AUTO_INCREMENT=n
Sicher reproduzieren
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'
Fragen
Wie finde ich heraus, auf welchem Schlüssel das Duplikat liegt?
Die Meldung nennt ihn: for key 'PRIMARY' ist der Primärschlüssel, alles andere ist der Name eines eindeutigen Index. SHOW INDEX FROM table_name; listet die Indizes und ihre Spalten auf.
Zugehörige Fehler
1452Fremdschlüssel schlägt fehl: untergeordnete Zeile kann nicht hinzugefügt werden1048Spalte darf nicht NULL sein1586Doppelter Eintrag für Schlüssel (mit Schlüsselname)23505PostgreSQL: Doppelter Schlüssel verletzt eindeutige Einschränkung2627SQL Server: Verletzung von PRIMARY KEY oder UNIQUE KEYORA-00001Oracle: Unique-Constraint verletztSQLITE_CONSTRAINT_UNIQUESQLite: UNIQUE-Constraint fehlgeschlagen
Weitere Fehler bei Schlüsseln und Constraints
1061Doppelter Schlüsselname1451Fremdschlüssel schlägt fehl: übergeordnete Zeile kann nicht gelöscht werden1216Kann keine untergeordnete Zeile hinzufügen oder aktualisieren1217Kann eine übergeordnete Zeile nicht löschen oder aktualisieren: Ein Fremdschlüssel-Constraint schlägt fehl1215Fremdschlüssel-Constraint kann nicht hinzugefügt werden3780Fremdschlüsselspalten sind inkompatibel1822Fehlender Index für Fremdschlüssel-Constraint1824Die referenzierte Tabelle konnte nicht geöffnet werden
Der Code und der Meldungstext stammen aus der MySQL 8.4 Fehlernachrichtenreferenz. Durchstöbere die vollständige MySQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.
Arbeiten mit MySQL in SQLly
Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für MySQL und die anderen Datenbanken, mit denen du arbeitest.