// SQLite-Fehlerreferenz

SQLITE_CONSTRAINT_PRIMARYKEY: PRIMARY KEY-Einschränkung fehlgeschlagen

Ein INSERT oder UPDATE würde einen Primärschlüsselwert duplizieren. Die Meldung von SQLite lautet immer noch UNIQUE constraint failed und nennt die Schlüsselspalte.

Ergebniscode
SQLITE_CONSTRAINT_PRIMARYKEY
Name
1555
Kategorie
Erweiterte Ergebnis-Codes
Fehlermeldung
UNIQUE constraint failed: orders.id

Was es bedeutet

SQLITE_CONSTRAINT_PRIMARYKEY (1555) ist der erweiterte Code für einen doppelten Primärschlüssel. Der Meldungstext ist derselbe wie bei jedem anderen Unique-Verstoß, UNIQUE constraint failed: table.column, am erweiterten Code unterscheidet ein Programm die beiden Fälle.

Bei einer INTEGER PRIMARY KEY Spalte kannst du den Wert weglassen (oder NULL übergeben), und SQLite vergibt die nächste rowid, wodurch die meisten Kollisionen vermieden werden.

Häufige Ursachen

  • Einfügen einer expliziten ID, die bereits existiert.
  • Kopieren von Zeilen zwischen Datenbanken mit ihren IDs, wenn sich die Bereiche überschneiden.
  • IDs werden in der Anwendung generiert, mit einem Schema, das sich wiederholen kann.

Wie du es behebst

  1. SQLite zuweisen lassen INTEGER PRIMARY KEY Werte, indem die Spalte weggelassen wird.

    INSERT INTO orders (customer_id, total) VALUES (42, 19.99);
    SELECT last_insert_rowid();
  2. Beim Zusammenführen von Daten Upsert auf dem Schlüssel durchführen oder vorhandene Zeilen überspringen.

    INSERT INTO orders (id, customer_id, total)
    SELECT id, customer_id, total FROM other.orders WHERE true
    ON CONFLICT (id) DO NOTHING;

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.