...
Eroare SQL · Constrângeri: UNIQUE, NOT NULL, CHECK, chei străine

UNIQUE constraint failed: index 'ix_clienti_email'

Pe scurt

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

Greșit
SQL
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');
Corect
SQL
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

Greșit
SQL
INSERT INTO clienti (nume, email)
SELECT nume, email FROM import_clienti;
Corect
SQL
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ă tu

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.

Codul care dă eroarea
SQL
INSERT INTO clienti (nume, email) VALUES
 ('Radu Ene', 'radu@exemplu.ro'),
 ('Ana P.', 'Ana@Exemplu.ro');
SELECT nume, email FROM clienti ORDER BY id;
După reparație, programul afișează
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.

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

← Toate erorile SQL

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ță 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.