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

ERROR: could not create unique index "clienti_email_key"

Pe scurt

Î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

Greșit
SQL
ALTER TABLE clienti ADD UNIQUE (email);
Corect
SQL
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

Greșit
SQL
CREATE UNIQUE INDEX ON clienti (email);  -- trece, dar Ana@ și ana@ rămân
Corect
SQL
UPDATE clienti SET email = lower(email);
CREATE UNIQUE INDEX ON clienti (lower(email));

Normalizarea și indexul pe expresie elimină și duplicatele ascunse.

Repară tu

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.

Codul care dă eroarea
SQL
ALTER TABLE abonati ADD CONSTRAINT abonati_email_key UNIQUE (email);
SELECT id, email FROM abonati ORDER BY id;
După reparație, programul afișează
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

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 cu ADD 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

← 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.