// SQL Server-Fehlerreferenz

SQL Server-Fehler 2627: Verletzung von PRIMARY KEY oder UNIQUE KEY

Ein INSERT oder UPDATE würde einen Wert in einem PRIMARY KEY- oder UNIQUE-Constraint duplizieren. Die Meldung nennt den Constraint, die Tabelle und den duplizierten Schlüsselwert.

Fehlernummer
2627
Schweregrad
14
Kategorie
Beschränkungen und Schlüssel
Fehlermeldung
Violation of %ls constraint '%.*ls'. Cannot insert duplicate key in object '%.*ls'. The duplicate key value is %ls.

Was es bedeutet

Primary-Key- und Unique-Constraints garantieren, dass keine zwei Zeilen denselben Schlüssel teilen. Wenn ein Schreibvorgang ein Duplikat erzeugen würde, stoppt SQL Server die Anweisung mit 2627, gefolgt von 3621 („Die Anweisung wurde beendet“). Die Meldung gibt an, um welche Art von Constraint es sich handelt (PRIMARY KEY oder UNIQUE KEY), dessen Name, die Tabelle und seit SQL Server 2017 den duplizierten Wert selbst.

Fehler 2601 ist derselbe Fehler bei einem eindeutigen Index, der kein Constraint ist.

Häufige Ursachen

  • Einfügen einer Zeile, deren Schlüssel bereits existiert, zum Beispiel beim erneuten Ausführen eines Ladevorgangs.
  • Einfügen expliziter Werte in eine Identitätsspalte mit IDENTITY_INSERT eingeschaltet, oder Zurücksetzen des Identitätssaatwerts unterhalb bestehender Werte.
  • Ein Batch-Insert aus einer Quelle, die selbst doppelte Schlüssel enthält.
  • Zwei Sitzungen, die denselben Schlüssel gleichzeitig einfügen: das Prüfen-und-Einfügen-Muster (IF NOT EXISTS ... INSERT) ist ohne Sperrhinweise nicht sicher.

Wie du es behebst

  1. Finde die vorhandene Zeile anhand des in der Meldung angezeigten Werts.

    SELECT * FROM dbo.Customers WHERE Email = N'[email protected]';
  2. Beim Laden Zeilen überspringen, die bereits existieren.

    INSERT INTO dbo.Customers (Email, Name)
    SELECT s.Email, s.Name
    FROM staging.Customers AS s
    WHERE NOT EXISTS (SELECT 1 FROM dbo.Customers AS c WHERE c.Email = s.Email);
  3. Prüfe die Quelle auf Duplikate, bevor du einfügst.

    SELECT Email, COUNT(*) FROM staging.Customers GROUP BY Email HAVING COUNT(*) > 1;
  4. Für ein nebenläufigkeitssicheres Upsert aktualisiere zuerst und füge ein, wenn nichts aktualisiert wurde, während du eine Bereichssperre hältst.

    BEGIN TRANSACTION;
    UPDATE dbo.Customers WITH (UPDLOCK, SERIALIZABLE) SET Name = @Name WHERE Email = @Email;
    IF @@ROWCOUNT = 0
        INSERT INTO dbo.Customers (Email, Name) VALUES (@Email, @Name);
    COMMIT;
  5. Wenn eine Identity-Spalte kollidiert, prüfe sie und setze den Zähler neu.

    DBCC CHECKIDENT ('dbo.Customers', NORESEED);  -- shows current and max values
    DBCC CHECKIDENT ('dbo.Customers', RESEED);

Sicher reproduzieren

CREATE TABLE #k (id int PRIMARY KEY);
INSERT INTO #k VALUES (1);
INSERT INTO #k VALUES (1);  -- Msg 2627 ... The duplicate key value is (1).
DROP TABLE #k;

Fragen

Was ist der Unterschied zwischen Fehler 2627 und 2601?

2627 wird durch einen PRIMARY KEY oder UNIQUE Constraint ausgelöst; 2601 durch einen eindeutigen Index, der mit CREATE UNIQUE INDEX erstellt wurde. Die Ursache und die Lösungen sind dieselben.

Kann ich SQL Server veranlassen, doppelte Schlüssel zu ignorieren?

Ein eindeutiger Index, der mit WITH (IGNORE_DUP_KEY = ON) erstellt wurde, verwirft doppelte Zeilen in einem INSERT mit einer Warnung, statt die Anweisung fehlschlagen zu lassen. Setze ihn nur gezielt ein, da er Daten stillschweigend verwirft.

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.