// PostgreSQL-Fehlerreferenz

PostgreSQL 42830: ungültiger Fremdschlüssel

Ein Fremdschlüssel verweist auf Spalten, die nicht durch einen Primärschlüssel oder eine UNIQUE-Einschränkung in der referenzierten Tabelle abgedeckt sind.

SQLSTATE
42830
Name
invalid_foreign_key
Kategorie
Syntaxfehler oder Zugriffsregelverletzung
Fehlermeldung
there is no unique constraint matching given keys for referenced table "customers"

Was es bedeutet

Ein Fremdschlüssel muss auf Spalten verweisen, die in der übergeordneten Tabelle garantiert eindeutig sind, entweder durch ihren Primärschlüssel oder einen UNIQUE Einschränkung (oder ein eindeutiger Index ohne Prädikat) genau auf diesen Spalten. Andernfalls kann PostgreSQL nicht feststellen, auf welche übergeordnete Zeile ein Kind verweist, und das Erstellen des Fremdschlüssels schlägt mit 42830 fehl.

Die Spalten müssen als Menge übereinstimmen: ein eindeutiger Constraint auf (tenant_id, id) erlaubt nicht, dass ein Fremdschlüssel nur auf id verweist.

Häufige Ursachen

  • Die referenzierte Spalte hat überhaupt keinen Primärschlüssel oder Unique-Constraint.
  • Der Fremdschlüssel verweist auf eine Teil- oder Obermenge der Spalten der eindeutigen Einschränkung.
  • Der eindeutige Index auf der übergeordneten Tabelle ist partiell (hat eine WHERE -Klausel), die keinen Fremdschlüssel unterstützen kann.

Wie du es behebst

  1. Füge auf den referenzierten Spalten einen Primärschlüssel oder Unique-Constraint hinzu, und erstelle dann den Fremdschlüssel.

    ALTER TABLE customers ADD CONSTRAINT customers_email_key UNIQUE (email);
    ALTER TABLE orders ADD FOREIGN KEY (customer_email) REFERENCES customers (email);
  2. Oder verweise mit derselben Spaltenliste auf den vorhandenen Schlüssel.

    ALTER TABLE orders
        ADD FOREIGN KEY (tenant_id, customer_id) REFERENCES customers (tenant_id, id);

Sicher reproduzieren

CREATE TEMP TABLE p (id int);
CREATE TEMP TABLE c (p_id int REFERENCES p (id));  -- ERROR: there is no unique constraint matching given keys for referenced table "p"

Zugehörige Fehler

Weitere Syntaxfehler oder Verletzungen von Zugriffsregeln

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

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