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

ON CONFLICT clause does not match any PRIMARY KEY or UNIQUE constraint

Pe scurt

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ă

Greșit
SQL
INSERT INTO stoc_depozit (cod, nume, cantitate)
VALUES ('P-200', 'Lampă LED', 10)
ON CONFLICT(nume) DO UPDATE SET cantitate = cantitate + excluded.cantitate;
Corect
SQL
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

Greșit
SQL
INSERT INTO note (elev_id, materie, nota) VALUES (1, 'Română', 9)
ON CONFLICT(elev_id) DO UPDATE SET nota = excluded.nota;
Corect
SQL
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ă tu

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.

Codul care dă eroarea
SQL
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;
După reparație, programul afișează
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.

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

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