// Référence des erreurs PostgreSQL

PostgreSQL 42830 : clé étrangère invalide

Une clé étrangère pointe vers des colonnes qui ne sont pas couvertes par une clé primaire ou une contrainte unique sur la table référencée.

SQLSTATE
42830
Nom
invalid_foreign_key
Catégorie
Erreur de syntaxe ou violation de règle d'accès
Message d'erreur
there is no unique constraint matching given keys for referenced table "customers"

Ce que cela signifie

Une clé étrangère doit référencer des colonnes garanties uniques dans la table parente, grâce à sa clé primaire ou à une UNIQUE une contrainte (ou un index unique sans prédicat) exactement sur ces colonnes. Sinon, PostgreSQL ne peut pas déterminer quelle ligne parente un enfant référence, et la création de la clé étrangère échoue avec 42830.

Les colonnes doivent correspondre en tant qu'ensemble : une contrainte unique sur (tenant_id, id) ne permet pas à une clé étrangère de référencer id seule.

Causes courantes

  • La colonne référencée ne comporte ni clé primaire ni contrainte unique.
  • La clé étrangère référence un sous-ensemble ou un sur-ensemble des colonnes de la contrainte unique.
  • L'index unique sur le parent est partiel (a une WHERE clause), ce qui ne permet pas d'y adosser une clé étrangère.

Comment le corriger

  1. Ajoutez une clé primaire ou une contrainte d'unicité sur les colonnes référencées, puis créez la clé étrangère.

    ALTER TABLE customers ADD CONSTRAINT customers_email_key UNIQUE (email);
    ALTER TABLE orders ADD FOREIGN KEY (customer_email) REFERENCES customers (email);
  2. Ou référencez la clé existante en utilisant la même liste de colonnes.

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

Reproduisez-le en toute sécurité

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"

Erreurs liées

Plus d'erreurs de syntaxe ou de violation de règle d'accès

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.