SQL Server-Fehler 2601: Kann keine doppelte Schlüsselzeile einfügen
Ein INSERT oder UPDATE würde einen doppelten Wert in einen eindeutigen Index einfügen. Die Nachricht benennt die Tabelle, den Index und den doppelten Schlüsselwert.
- Fehlernummer
2601- Schweregrad
- 14
- Kategorie
- Beschränkungen und Schlüssel
Was es bedeutet
Fehler 2601 wird durch einen eindeutigen Index ausgelöst, der erstellt wurde mit CREATE UNIQUE INDEX, einschließlich gefilterter eindeutiger Indizes. Es ist das Index-Äquivalent zu 2627, das von PRIMARY KEY- und UNIQUE-Constraints stammt. Die Anweisung wird gestoppt und ihre Änderungen werden zurückgerollt.
Häufige Ursachen
- Einen Wert schreiben, den eine andere Zeile bereits in einer durch einen eindeutigen Index abgedeckten Spalte hat.
- Ein eindeutiger Index auf einer NULL-fähigen Spalte: SQL Server behandelt NULLs in eindeutigen Indizes als gleich, daher darf nur eine Zeile NULL enthalten, es sei denn, der Index ist gefiltert.
- Ein Ladevorgang, dessen Quelle Duplikate enthält.
Wie du es behebst
-
Finde die Zeile mit dem Konfliktwert aus der Meldung, und aktualisiere sie oder überspringe die neue.
SELECT * FROM dbo.Users WHERE UserName = N'ada';
-
Um viele NULLs zuzulassen und gleichzeitig Nicht-NULL-Werte eindeutig zu halten, lege einen gefilterten Index an.
DROP INDEX UX_Users_TaxId ON dbo.Users; CREATE UNIQUE INDEX UX_Users_TaxId ON dbo.Users (TaxId) WHERE TaxId IS NOT NULL;
-
Prüfe, welche Spalten der Index abdeckt.
EXEC sp_helpindex 'dbo.Users';
Sicher reproduzieren
CREATE TABLE #u (v int NULL); CREATE UNIQUE INDEX ux ON #u (v); INSERT INTO #u VALUES (NULL); INSERT INTO #u VALUES (NULL); -- Msg 2601: The duplicate key value is (<NULL>). DROP TABLE #u;
Fragen
Warum kann ich kein zweites NULL in eine eindeutige Spalte einfügen?
In SQL Server behandelt ein eindeutiger Index oder eine Einschränkung NULL als Wert, sodass nur ein NULL erlaubt ist. Ein gefilterter eindeutiger Index mit WHERE Spalte IS NOT NULL erlaubt beliebig viele NULLs.
Zugehörige Fehler
2627Verstoß gegen PRIMARY KEY oder UNIQUE KEY1913Index- oder Statistikname existiert bereits23505PostgreSQL: Doppelter Schlüssel verletzt eindeutige Einschränkung1062MySQL: Doppelter Eintrag für SchlüsselORA-00001Oracle: Unique-Constraint verletzt
Weitere Fehler bei Constraints und Schlüsseln
547Anweisung kollidierte mit einem Constraint515Kann den NULL-Wert nicht in die Spalte einfügen3726Kann nicht gelöscht werden: wird von einem FOREIGN KEY referenziert1750Konnte Beschränkung oder Index nicht erstellen4712Eine referenzierte Tabelle kann nicht geleert werden1505Doppelter Schlüssel gefunden, eindeutiger Index
Der Code und der Meldungstext stammen aus der Microsoft Database Engine-Ereignisse und Fehlernachschlagewerk. Durchstöbere die vollständige SQL Server-Fehlerliste oder Jeden Datenbankfehler durchsuchen.
Arbeiten mit SQL Server 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 SQL Server und die anderen Datenbanken, mit denen du arbeitest.