UNIQUE constraint failed: index 'ix_clienti_email'
Rândul nou are aceeași valoare ca altul într-un index unic pe o expresie, de exemplu CREATE UNIQUE INDEX ... ON clienti(lower(email)). Mesajul numește indexul, nu coloana. Verifică valoarea după aceeași expresie înainte de INSERT sau folosește INSERT OR IGNORE / ON CONFLICT DO NOTHING.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când unicitatea e pe coloane simple, SQLite spune ce coloane s-au repetat: UNIQUE constraint failed: clienti.email. Când indexul unic e pe o expresie (lower(email), trim(cod), date(creat)), nu există o coloană de numit, așa că mesajul numește indexul: UNIQUE constraint failed: index 'ix_clienti_email'.
Un astfel de index e folosit des ca emailurile să fie unice indiferent de litere mari și mici: Ana@Exemplu.ro și ana@exemplu.ro dau aceeași valoare după lower(), deci al doilea INSERT e respins, deși textul nu e identic.
Ca să găsești conflictul, caută după aceeași expresie: SELECT * FROM clienti WHERE lower(email) = lower('Ana@Exemplu.ro');. Definiția indexului o vezi cu SELECT sql FROM sqlite_master WHERE name = 'ix_clienti_email';.
De ce apare: cauzele frecvente
1Același email scris cu alte litere
CREATE UNIQUE INDEX ix_clienti_email ON clienti (lower(email));
INSERT INTO clienti (nume, email) VALUES ('Ana', 'ana@exemplu.ro');
INSERT INTO clienti (nume, email) VALUES ('Ana P.', 'Ana@Exemplu.ro');INSERT OR IGNORE INTO clienti (nume, email) VALUES ('Ana P.', 'Ana@Exemplu.ro');Indexul compară lower(email), deci cele două adrese sunt identice pentru el. OR IGNORE sare peste rândul duplicat.
2Import cu duplicate ascunse
INSERT INTO clienti (nume, email)
SELECT nume, email FROM import_clienti;INSERT INTO clienti (nume, email)
SELECT nume, email FROM import_clienti i
WHERE NOT EXISTS (SELECT 1 FROM clienti c WHERE lower(c.email) = lower(i.email))
GROUP BY lower(email);Filtrezi după aceeași expresie ca indexul și păstrezi un singur rând pe fiecare email din import.
Repară eroarea, direct în pagină
Emailurile clienților sunt unice indiferent de litere mari, printr-un index pe lower(email). Importul adaugă și o adresă care există deja scrisă altfel și dă UNIQUE constraint failed: index 'ix_clienti_email'. Repară inserarea ca adresele duplicate să fie sărite, apoi afișează nume și email ordonat după id.
INSERT INTO clienti (nume, email) VALUES
('Radu Ene', 'radu@exemplu.ro'),
('Ana P.', 'Ana@Exemplu.ro');
SELECT nume, email FROM clienti ORDER BY id;nume | email Ana Popa | ana@exemplu.ro Radu Ene | radu@exemplu.ro
Indiciu
Există o variantă a lui INSERT care ignoră rândurile ce încalcă o constrângere.
Reparația
INSERT OR IGNORE INTO clienti (nume, email) VALUES
('Radu Ene', 'radu@exemplu.ro'),
('Ana P.', 'Ana@Exemplu.ro');
SELECT nume, email FROM clienti ORDER BY id;De ce merge
Indexul unic compară lower(email), deci Ana@Exemplu.ro e același email cu ana@exemplu.ro. Fără tratarea conflictului, tot INSERT-ul e anulat, inclusiv rândul bun. Cu INSERT OR IGNORE, SQLite inserează rândul lui Radu și sare doar peste duplicat, așa că rămân doi clienți.
Alte forme ale mesajului
sqlite3.IntegrityError: UNIQUE constraint failed: index 'ix_clienti_email'ERROR: duplicate key value violates unique constraint "ix_clienti_email"
Cum o eviți pe viitor
Normalizează datele la scriere (de exemplu salvezi emailul deja cu lower(trim(email))), ca să nu depinzi doar de index. Când inserezi date care pot exista deja, alege conștient: INSERT OR IGNORE sau ON CONFLICT DO NOTHING (păstrezi rândul vechi) ori ON CONFLICT DO UPDATE (îl actualizezi). Dă indecșilor nume clare, ca mesajul să spună singur ce regulă a fost încălcată.
Întrebări frecvente
Pot folosi ON CONFLICT(email) cu un index pe lower(email)?
Nu cu (email), pentru că ținta trebuie să fie exact expresia indexului: ON CONFLICT (lower(email)) DO NOTHING. Fără țintă, ON CONFLICT DO NOTHING acoperă orice constrângere.
E mai bine COLLATE NOCASE?
Pentru litere ASCII, email TEXT UNIQUE COLLATE NOCASE face același lucru și mesajul numește coloana. lower() e mai explicit, iar ambele tratează doar literele A-Z, nu și diacriticele.
Erori înrudite
UNIQUE constraint failed: clienti.email Încerci să inserezi sau să actualizezi un rând cu o valoare care există deja într-o coloană declarată UNIQUE (aici clienti.email). Baza de date refuză duplicatul. Folosește altă valoare, actualizează rândul existent sau tratează conflictul cu INSERT OR IGNORE ori ON CONFLICT. ON CONFLICT clause does not match any PRIMARY KEY or UNIQUE constraint Coloana din ON CONFLICT(coloana) nu are o constrângere PRIMARY KEY sau UNIQUE, deci SQLite nu are ce conflict să detecteze. Pune în ON CONFLICT coloana care chiar e unică (de obicei cheia primară) sau adaugă un index UNIQUE pe coloana dorită. expressions prohibited in PRIMARY KEY and UNIQUE constraints Într-o constrângere UNIQUE sau PRIMARY KEY ai pus o expresie, de exemplu UNIQUE(lower(email)). Constrângerile primesc doar nume de coloane. Pentru unicitate pe o expresie, creează un index unic: CREATE UNIQUE INDEX ix ON clienti(lower(email)). Învață SQL de la zero, cu exerciții la fiecare lecție
Curs SQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
