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
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
UPDATEdie die Spalte auf einen Wert setzt, den eine andere Zeile bereits hat.
Wie du es behebst
-
Finde die vorhandene Zeile.
SELECT * FROM users WHERE email = '[email protected]';
-
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; -
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
SQLITE_CONSTRAINT_PRIMARYKEYPRIMARY KEY-Constraint fehlgeschlagenSQLITE_CONSTRAINTConstraint fehlgeschlagen23505PostgreSQL: Doppelter Schlüssel verletzt eindeutige Einschränkung1062MySQL: Doppelter Eintrag für Schlüssel2627SQL Server: Verletzung von PRIMARY KEY oder UNIQUE KEY2601SQL Server: Kann keine doppelte Schlüsselzeile einfügenORA-00001Oracle: Unique-Constraint verletzt
Weitere Fehler bei erweiterten Ergebniscodes
SQLITE_ERROR_MISSING_COLLSEQkeine solche SortierreihenfolgeSQLITE_BUSY_RECOVERYein anderer Prozess stellt das WAL wieder herSQLITE_LOCKED_SHAREDCACHEDatensatz im gemeinsamen Cache gesperrtSQLITE_CONSTRAINT_CHECKCHECK-Constraint fehlgeschlagenSQLITE_ABORT_ROLLBACKAnweisung durch ROLLBACK abgebrochenSQLITE_BUSY_SNAPSHOTein veralteter Lesevorgang kann nicht zu einem Schreibvorgang werdenSQLITE_IOERR_SHORT_READLesevorgang lieferte weniger Bytes zurückSQLITE_CANTOPEN_ISDIRder Pfad ist ein Verzeichnis
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.
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.