// SQL Server-Fehlerreferenz

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
Fehlermeldung
Cannot insert duplicate key row in object '%.*ls' with unique index '%.*ls'. The duplicate key value is %ls.

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

  1. Finde die Zeile mit dem Konfliktwert aus der Meldung, und aktualisiere sie oder überspringe die neue.

    SELECT * FROM dbo.Users WHERE UserName = N'ada';
  2. 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;
  3. 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

Weitere Fehler bei Constraints und Schlüsseln

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.

// weniger Fehler, schnellere Korrekturen

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.