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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
UPSERT-ul (INSERT ... ON CONFLICT(coloana) DO UPDATE ...) înseamnă: „inserează rândul, iar dacă există deja un rând cu aceeași valoare în coloana unică, actualizează-l”. Pentru asta, coloana (sau combinația de coloane) din ON CONFLICT(...) trebuie să corespundă exact unei chei primare, unei constrângeri UNIQUE sau unui index unic.
Mesajul apare când pui în paranteze o coloană obișnuită, de exemplu ON CONFLICT(nume) când unicitatea e pe cod, sau o combinație care nu are index unic exact pe acele coloane (ON CONFLICT(elev_id) când constrângerea e UNIQUE (elev_id, materie)).
Verifică ce constrângeri are tabelul: PRAGMA index_list(stoc_depozit); arată indexurile unice, iar cheia primară se vede în definiția tabelului.
De ce apare: cauzele frecvente
1Coloana din ON CONFLICT nu e unică
INSERT INTO stoc_depozit (cod, nume, cantitate)
VALUES ('P-200', 'Lampă LED', 10)
ON CONFLICT(nume) DO UPDATE SET cantitate = cantitate + excluded.cantitate;INSERT INTO stoc_depozit (cod, nume, cantitate)
VALUES ('P-200', 'Lampă LED', 10)
ON CONFLICT(cod) DO UPDATE SET cantitate = cantitate + excluded.cantitate;Cheia primară e cod, deci conflictul se detectează pe cod. Coloana nume nu are constrângere de unicitate.
2Unicitatea e pe două coloane
INSERT INTO note (elev_id, materie, nota) VALUES (1, 'Română', 9)
ON CONFLICT(elev_id) DO UPDATE SET nota = excluded.nota;INSERT INTO note (elev_id, materie, nota) VALUES (1, 'Română', 9)
ON CONFLICT(elev_id, materie) DO UPDATE SET nota = excluded.nota;Dacă tabelul are UNIQUE (elev_id, materie), ON CONFLICT trebuie să enumere exact aceste coloane.
Repară eroarea, direct în pagină
La recepția unei livrări, stocul trebuie actualizat: Lampa LED (cod P-200) primește 10 bucăți în plus, iar produsul nou „Prelungitor” (cod P-400) intră cu 12 bucăți. UPSERT-ul dă eroarea ON CONFLICT clause does not match any PRIMARY KEY or UNIQUE constraint. Repară-l. Se afișează apoi cod, nume, cantitate, ordonate după cod.
INSERT INTO stoc_depozit (cod, nume, cantitate, actualizat) VALUES
('P-200', 'Lampă LED', 10, '2026-04-15'),
('P-400', 'Prelungitor', 12, '2026-04-15')
ON CONFLICT(nume) DO UPDATE SET
cantitate = cantitate + excluded.cantitate,
actualizat = excluded.actualizat;
SELECT cod, nume, cantitate FROM stoc_depozit ORDER BY cod;cod | nume | cantitate P-100 | Mouse wireless | 40 P-200 | Lampă LED | 35 P-300 | Bec inteligent | 60 P-400 | Prelungitor | 12
Indiciu
Cheia primară a tabelului stoc_depozit este cod.
Reparația
INSERT INTO stoc_depozit (cod, nume, cantitate, actualizat) VALUES
('P-200', 'Lampă LED', 10, '2026-04-15'),
('P-400', 'Prelungitor', 12, '2026-04-15')
ON CONFLICT(cod) DO UPDATE SET
cantitate = cantitate + excluded.cantitate,
actualizat = excluded.actualizat;
SELECT cod, nume, cantitate FROM stoc_depozit ORDER BY cod;De ce merge
ON CONFLICT(nume) cerea un conflict pe o coloană care nu e unică, iar SQLite nu are cum să-l detecteze. Cheia primară este cod, deci ON CONFLICT(cod) urmărește exact constrângerea care există.
Pentru P-200, codul există deja, așa că se execută DO UPDATE: 25 + 10 = 35 de bucăți. P-400 nu există, deci se inserează ca rând nou, cu 12 bucăți.
Alte forme ale mesajului
ERROR: there is no unique or exclusion constraint matching the ON CONFLICT specification
Cum o eviți pe viitor
Înainte să scrii un UPSERT, stabilește ce înseamnă „același rând”: același cod, același email, aceeași pereche elev-materie. Asigură-te că exact acea coloană sau combinație are PRIMARY KEY, UNIQUE sau un CREATE UNIQUE INDEX. Dacă nu are, adaugă indexul: CREATE UNIQUE INDEX ux_stoc_nume ON stoc_depozit(nume);, dar doar dacă valorile chiar sunt unice în realitate.
Întrebări frecvente
În MySQL nu scriu coloana. De ce aici trebuie?
MySQL are INSERT ... ON DUPLICATE KEY UPDATE, care reacționează la orice cheie unică. SQLite și PostgreSQL folosesc ON CONFLICT(coloane), unde spui explicit ce constrângere urmărești. În SQLite poți omite coloana doar la DO NOTHING.
Ce e excluded?
excluded este rândul pe care ai încercat să-l inserezi. În DO UPDATE SET cantitate = cantitate + excluded.cantitate, cantitate e valoarea existentă, iar excluded.cantitate valoarea nouă.
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. UNIQUE constraint failed: produse.id Inserezi un rând cu un id care există deja în tabel. Cheia primară e unică. Nu da id-ul la INSERT (lasă SQLite să-l genereze pentru INTEGER PRIMARY KEY) sau folosește un id liber; dacă vrei să înlocuiești rândul, folosește UPDATE sau ON CONFLICT. NOT NULL constraint failed: produse.nume Coloana produse.nume este declarată NOT NULL, dar INSERT-ul sau UPDATE-ul îi lasă valoarea NULL: ai uitat coloana din listă sau ai trimis explicit NULL. Dă o valoare pentru coloană sau, dacă are sens, pune-i o valoare implicită cu DEFAULT. Î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.
