// SQLite-Fehlerreferenz

SQLITE_CONSTRAINT_UNIQUE: UNIQUE-Einschränkung fehlgeschlagen

Ein INSERT oder UPDATE würde einen Wert in einer UNIQUE-Spalte oder einem eindeutigen Index duplizieren. Die Meldung nennt die Tabelle und die Spalte.

Ergebniscode
SQLITE_CONSTRAINT_UNIQUE
Name
2067
Kategorie
Erweiterte Ergebnis-Codes
Fehlermeldung
UNIQUE constraint failed: users.email

Was es bedeutet

SQLite gibt zurück SQLITE_CONSTRAINT_UNIQUE (2067), wenn ein Schreibvorgang zwei Zeilen mit demselben Wert in einer UNIQUE Constraint oder einem eindeutigen Index erzeugen würde. Die Meldung listet die Spalten auf, table.column, kommagetrennt bei einem mehrspaltigen Schlüssel. Doppelte Primärschlüssel werden mit SQLITE_CONSTRAINT_PRIMARYKEY gemeldet, aber derselbe Meldungstext wird verwendet.

NULLs zählen nicht als Duplikate: Eine eindeutige Spalte kann beliebig viele NULLs enthalten.

Häufige Ursachen

  • Einfügen einer Zeile, die bereits existiert, zum Beispiel beim erneuten Ausführen eines Imports.
  • Zwei Werte, die sich nur in der Groß-/Kleinschreibung unterscheiden, in einer Spalte deklariert COLLATE NOCASE.
  • Eine UPDATE die die Spalte auf einen Wert setzt, den eine andere Zeile bereits hat.

Wie du es behebst

  1. Finde die vorhandene Zeile.

    SELECT * FROM users WHERE email = '[email protected]';
  2. Aktualisiere stattdessen die vorhandene Zeile, per Upsert (SQLite 3.24 und neuer).

    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = excluded.name;
  3. Oder überspringe Duplikate gezielt.

    INSERT OR IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');

Sicher reproduzieren

CREATE TABLE users (email TEXT UNIQUE);
INSERT INTO users VALUES ('a@x');
INSERT INTO users VALUES ('a@x');  -- Runtime error: UNIQUE constraint failed: users.email (19)

Fragen

Was ist der Unterschied zwischen INSERT OR REPLACE und einem Upsert?

INSERT OR REPLACE löscht die widersprüchliche Zeile und fügt eine neue ein, sodass Spalten, die du nicht angegeben hast, zurückgesetzt werden und DELETE-Trigger sowie Fremdschlüssel-Aktionen ausgelöst werden können. Ein Upsert mit ON CONFLICT DO UPDATE ändert die bestehende Zeile an Ort und Stelle.

Zugehörige Fehler

Weitere Fehler bei erweiterten Ergebniscodes

Der Code und der Meldungstext stammen aus der SQLite-Dokumentation zu Ergebnis- und Fehlercodes. Durchstöbere die vollständige SQLite-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit SQLite 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 SQLite und die anderen Datenbanken, mit denen du arbeitest.