...
Eroare PostgreSQL · Constrângeri, chei și secvențe

ERROR: there is no unique constraint matching given keys for referenced table "clienti"

Pe scurt

O cheie străină referă o coloană (sau un set de coloane) din tabelul părinte care nu are cheie primară sau constrângere UNIQUE. PostgreSQL cere ca valorile referite să fie unice. Adaugă UNIQUE pe coloana referită sau referă cheia primară a tabelului.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

O cheie străină trebuie să indice exact un rând din tabelul părinte, deci coloanele referite trebuie să aibă o constrângere unică (cheie primară, UNIQUE sau index unic fără condiție și fără expresii). Un index obișnuit nu ajunge. Dacă scrii REFERENCES clienti(email) și email nu e unic, PostgreSQL refuză cu acest mesaj.

Cauze frecvente: referirea unei coloane naturale (email, cod) care nu a fost declarată unică; o cheie compusă referită doar parțial (REFERENCES t(a) când unicitatea e pe (a, b)); o constrângere unică amânabilă (DEFERRABLE), care nu poate fi referită; un index unic parțial. De obicei e mai bine să referi cheia primară tehnică (id); dacă vrei totuși o cheie naturală, declar-o explicit UNIQUE.

De ce apare: cauzele frecvente

1Referire la o coloană fără UNIQUE

Greșit
SQL
CREATE TABLE abonari (email text REFERENCES clienti(oras));
Corect
SQL
CREATE TABLE abonari (client_id int REFERENCES clienti(id));

Cheia primară este unică prin definiție.

2Cheie naturală nedeclarată unică

Greșit
SQL
CREATE TABLE coduri (cod text);
CREATE TABLE vanzari (cod text REFERENCES coduri(cod));
Corect
SQL
CREATE TABLE coduri (cod text PRIMARY KEY);
CREATE TABLE vanzari (cod text REFERENCES coduri(cod));

Coloana referită devine unică.

Repară tu

Repară eroarea, direct în pagină

Tabelul facturi vrea să refere codul fiscal din firme, dar crearea cheii străine dă there is no unique constraint matching given keys for referenced table "firme". Fă codul fiscal unic, creează tabelul facturi și afișează facturile cu numele firmei.

Codul care dă eroarea
SQL
CREATE TABLE facturi (nr int PRIMARY KEY, cui text REFERENCES firme(cui));
INSERT INTO facturi VALUES (1, 'RO123');
SELECT f.nr, fi.nume FROM facturi f JOIN firme fi ON fi.cui = f.cui;
După reparație, programul afișează
ALTER TABLE
CREATE TABLE
INSERT 0 1
 nr |    nume
----+-------------
  1 | Exemplu SRL
(1 rând)
Indiciu

ALTER TABLE firme ADD UNIQUE (cui)

Cum o eviți pe viitor

  • Referă de preferință cheia primară a tabelului părinte.
  • Declară UNIQUE orice cheie naturală pe care vrei să o referi.
  • Pentru chei compuse, referă toate coloanele cheii, în aceeași ordine.
  • Evită constrângerile unice amânabile pe coloane referite din alte tabele.

Întrebări frecvente

De ce nu ajunge un index obișnuit?

Indexul obișnuit permite duplicate, deci o valoare din tabelul copil ar putea corespunde mai multor părinți.

Pot referi un index unic parțial?

Nu. Cheia străină cere o constrângere unică pe toate rândurile, fără condiții.

Erori înrudite

← Toate erorile PostgreSQL

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață PostgreSQL de la zero, cu exerciții la fiecare lecție

Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.