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

UNIQUE constraint failed: produse.id

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Cheia primară (PRIMARY KEY) identifică în mod unic fiecare rând, deci nu pot exista două rânduri cu același id. Pentru o coloană INTEGER PRIMARY KEY, SQLite raportează încălcarea ca UNIQUE constraint failed: produse.id; pentru alte chei primare (de exemplu un cod text) mesajul are aceeași formă.

Cauza cea mai frecventă: scrii manual id-ul în INSERT INTO produse VALUES (1, ...), deși rândul 1 există. Alte cauze: rulezi de două ori același script de date, copiezi rânduri dintr-un tabel în altul fără să scoți id-ul sau încerci să „modifici” un rând inserându-l din nou.

Cu INTEGER PRIMARY KEY nu ai nevoie să dai id-ul: dacă îl omiți din listă sau pui NULL, SQLite alege automat următoarea valoare.

De ce apare: cauzele frecvente

1Id dat manual, deja folosit

Greșit
SQL
INSERT INTO produse VALUES (10, 'Hub USB-C', 'Electronice', 159, 30);
Corect
SQL
INSERT INTO produse (nume, categorie, pret, stoc)
VALUES ('Hub USB-C', 'Electronice', 159, 30);

Fără id în listă, SQLite îi dă produsului următoarea valoare liberă (aici 11).

2Rândul trebuia actualizat, nu inserat

Greșit
SQL
INSERT INTO produse VALUES (6, 'Lampă LED', 'Iluminat', 135, 25);
Corect
SQL
UPDATE produse SET pret = 135 WHERE id = 6;

Rândul cu id 6 există deja. Pentru a-i schimba prețul folosești UPDATE.

3Copiere între tabele cu tot cu id

Greșit
SQL
INSERT INTO produse SELECT * FROM produse_noi;
Corect
SQL
INSERT INTO produse (nume, categorie, pret, stoc)
SELECT nume, categorie, pret, stoc FROM produse_noi;

Dacă produse_noi are id-uri care se suprapun cu cele existente, inserarea pică. Fără coloana id, SQLite generează id-uri noi.

Repară tu

Repară eroarea, direct în pagină

Scriptul adaugă în catalog produsul „Hub USB-C” (Electronice, 159 lei, stoc 30) și afișează apoi produsele din Electronice cu preț sub 200 de lei (id, nume, pret), ordonate după id. Acum dă UNIQUE constraint failed: produse.id. Repară inserarea astfel încât id-ul să fie generat automat.

Codul care dă eroarea
SQL
INSERT INTO produse VALUES (10, 'Hub USB-C', 'Electronice', 159, 30);

SELECT id, nume, pret
FROM produse
WHERE categorie = 'Electronice' AND pret < 200
ORDER BY id;
După reparație, programul afișează
id | nume | pret
2 | Mouse wireless | 89.9
11 | Hub USB-C | 159
Indiciu

Scoate id-ul din INSERT și scrie lista de coloane.

Alte forme ale mesajului

  • UNIQUE constraint failed: stoc_depozit.cod
  • ERROR 1062 (23000): Duplicate entry '10' for key 'produse.PRIMARY'
  • ERROR: duplicate key value violates unique constraint "produse_pkey"

Cum o eviți pe viitor

Pentru tabelele cu INTEGER PRIMARY KEY, nu da niciodată id-ul la inserarea datelor noi: scrie lista de coloane fără id. Folosește mereu forma cu listă de coloane (INSERT INTO produse (nume, pret) VALUES ...), nu INSERT INTO produse VALUES (...). Când un script trebuie să poată rula de mai multe ori, folosește INSERT OR IGNORE sau ON CONFLICT(id) DO UPDATE.

Întrebări frecvente

De ce mesajul spune UNIQUE, nu PRIMARY KEY?

SQLite raportează orice cheie primară duplicată ca UNIQUE constraint failed, pentru că cheia primară este implementată ca o constrângere de unicitate (plus, la alte tipuri decât INTEGER, un index unic). Numele coloanei din mesaj îți arată că e vorba de cheia primară.

INSERT OR REPLACE rezolvă problema?

Da, dar cu grijă: șterge rândul vechi și inserează unul nou. Coloanele pe care nu le dai primesc valoarea implicită, iar cheile străine cu ON DELETE CASCADE pot șterge rânduri din alte tabele. ON CONFLICT ... DO UPDATE e de obicei alegerea mai sigură.

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.