ERROR: there is no unique constraint matching given keys for referenced table "clienti"
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
CREATE TABLE abonari (email text REFERENCES clienti(oras));CREATE TABLE abonari (client_id int REFERENCES clienti(id));Cheia primară este unică prin definiție.
2Cheie naturală nedeclarată unică
CREATE TABLE coduri (cod text);
CREATE TABLE vanzari (cod text REFERENCES coduri(cod));CREATE TABLE coduri (cod text PRIMARY KEY);
CREATE TABLE vanzari (cod text REFERENCES coduri(cod));Coloana referită devine unică.
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.
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;ALTER TABLE CREATE TABLE INSERT 0 1 nr | nume ----+------------- 1 | Exemplu SRL (1 rând)
Indiciu
ALTER TABLE firme ADD UNIQUE (cui)
Reparația
ALTER TABLE firme ADD UNIQUE (cui);
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;De ce merge
Coloana cui nu era declarată unică, deci o factură ar fi putut corespunde mai multor firme. ADD UNIQUE (cui) creează constrângerea și indexul unic necesare, iar cheia străină poate fi definită. Factura 1 se leagă de firma Exemplu SRL prin JOIN pe codul fiscal.
Cum o eviți pe viitor
- Referă de preferință cheia primară a tabelului părinte.
- Declară
UNIQUEorice 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
ERROR: foreign key constraint "comenzi_client_id_fkey" cannot be implemented Coloana cheii străine și coloana referită au tipuri incompatibile, de exemplu text în tabelul copil și integer în părinte. DETAIL spune ambele tipuri. Folosește în tabelul copil exact tipul cheii referite (int cu int, bigint cu bigint, uuid cu uuid). ERROR: insert or update on table "comenzi" violates foreign key constraint "comenzi_client_id_fkey" Rândul nou (sau modificat) trimite printr-o cheie străină la un rând care nu există în tabelul părinte, de exemplu o comandă pentru clientul 99. DETAIL arată valoarea lipsă. Creează întâi rândul părinte sau corectează valoarea cheii străine. ERROR: could not create unique index "clienti_email_key" Încerci să adaugi o constrângere UNIQUE (sau un index unic, sau o cheie primară) pe o coloană care are deja valori duplicate. DETAIL arată prima pereche duplicată. Găsește și rezolvă duplicatele (șterge, combină sau corectează), apoi creează din nou constrângerea. Î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.
