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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Crearea unei constrângeri UNIQUE, a unei chei primare sau a unui index unic construiește indexul pe datele existente. Dacă găsește două rânduri cu aceeași valoare, oprește operația cu acest mesaj și DETAIL: Key (email)=(ana@exemplu.ro) is duplicated. Este afișată doar prima pereche întâlnită; pot exista mai multe.
Pașii obișnuiți: găsești toate duplicatele (SELECT email, count(*) FROM clienti GROUP BY email HAVING count(*) > 1), decizi regula (păstrezi cel mai vechi rând, combini datele, corectezi manual), ștergi sau actualizezi rândurile în plus, apoi creezi constrângerea. Atenție la duplicatele „aproape egale”: diferențele de majuscule sau spații nu sunt duplicate pentru un index obișnuit, dar sunt pentru utilizatori; un index unic pe lower(email) le prinde și pe ele.
De ce apare: cauzele frecvente
1Duplicate în date
ALTER TABLE clienti ADD UNIQUE (email);DELETE FROM clienti a USING clienti b
WHERE a.email = b.email AND a.id > b.id;
ALTER TABLE clienti ADD UNIQUE (email);Se păstrează rândul cu id-ul cel mai mic pentru fiecare email.
2Duplicate care diferă prin majuscule
CREATE UNIQUE INDEX ON clienti (email); -- trece, dar Ana@ și ana@ rămânUPDATE clienti SET email = lower(email);
CREATE UNIQUE INDEX ON clienti (lower(email));Normalizarea și indexul pe expresie elimină și duplicatele ascunse.
Repară eroarea, direct în pagină
Tabelul abonati are emailuri duplicate, iar adăugarea constrângerii UNIQUE pe email dă could not create unique index. Șterge duplicatele păstrând rândul cu id-ul cel mai mic pentru fiecare email, adaugă constrângerea și afișează id-ul și emailul rândurilor rămase.
ALTER TABLE abonati ADD CONSTRAINT abonati_email_key UNIQUE (email);
SELECT id, email FROM abonati ORDER BY id;DELETE 1 ALTER TABLE id | email ----+---------------- 1 | ana@exemplu.ro 2 | dan@exemplu.ro (2 rânduri)
Indiciu
DELETE ... USING abonati b WHERE a.email = b.email AND a.id > b.id
Reparația
DELETE FROM abonati a USING abonati b
WHERE a.email = b.email AND a.id > b.id;
ALTER TABLE abonati ADD CONSTRAINT abonati_email_key UNIQUE (email);
SELECT id, email FROM abonati ORDER BY id;De ce merge
Emailul ana@exemplu.ro apărea de două ori, deci indexul unic nu putea fi construit. DELETE ... USING compară tabelul cu el însuși și șterge rândurile care au un „frate” cu același email și id mai mic. Rămâne câte un rând pe email (id 1 și 2), iar constrângerea se creează fără probleme.
Cum o eviți pe viitor
- Adaugă constrângerile de unicitate la crearea tabelelor, înainte să apară date duplicate.
- Găsește duplicatele cu
GROUP BY ... HAVING count(*) > 1înaintea migrării. - Normalizează valorile (lower, trim) înainte de constrângere.
- Pe tabele mari, creează indexul cu
CREATE UNIQUE INDEX CONCURRENTLY, apoi atașează-l ca constrângere cuADD CONSTRAINT ... UNIQUE USING INDEX.
Întrebări frecvente
Ce rămâne după un CREATE UNIQUE INDEX CONCURRENTLY eșuat?
Un index marcat INVALID, care trebuie șters (DROP INDEX) înainte de o nouă încercare.
Ce rând păstrez dintre duplicate?
Depinde de domeniu: de obicei cel mai vechi (id minim), după ce muți referințele (comenzile) de pe rândurile șterse pe cel păstrat.
Erori înrudite
ERROR: duplicate key value violates unique constraint "produse_pkey" Încerci să inserezi sau să actualizezi un rând cu o valoare care există deja într-o coloană cu cheie primară sau UNIQUE. Linia DETAIL arată cheia duplicată. Un caz frecvent: secvența unei coloane identity/serial a rămas în urmă după inserări cu id-uri explicite, iar următorul id generat există deja. ERROR: check constraint "pret_pozitiv" of relation "oferte" is violated by some row Adaugi o constrângere CHECK pe un tabel care conține deja rânduri care nu o respectă. PostgreSQL verifică toate rândurile existente. Corectează întâi datele sau adaugă constrângerea cu NOT VALID (se aplică doar rândurilor noi) și valideaz-o după curățare. ERROR: column "telefon" of relation "clienti" contains null values Încerci să faci o coloană NOT NULL (ALTER COLUMN ... SET NOT NULL sau ADD COLUMN ... NOT NULL fără DEFAULT), dar unele rânduri existente au NULL în ea. Completează întâi valorile lipsă cu un UPDATE sau adaugă coloana cu un DEFAULT. Î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.
