CHECK constraint failed: pret >= 0
Valoarea pe care o inserezi sau o actualizezi încalcă o regulă CHECK din definiția tabelului (aici pret >= 0). Mesajul arată regula sau numele constrângerii. Corectează valoarea; schimbă regula doar dacă ea e cea greșită.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O constrângere CHECK este o condiție pe care fiecare rând trebuie s-o respecte, de exemplu CHECK (pret >= 0) sau CHECK (status IN ('activ', 'inactiv')). Dacă un INSERT sau UPDATE ar produce un rând pentru care condiția este falsă, SQLite îl refuză cu CHECK constraint failed: urmat de expresia constrângerii. Dacă i-ai dat un nume (CONSTRAINT pret_pozitiv CHECK (...)), mesajul arată numele.
Cauzele frecvente: o valoare introdusă greșit (preț negativ, notă 11), un calcul în UPDATE care depășește limita (reducere aplicată de două ori, stoc scăzut sub zero) sau o valoare text care nu e în lista permisă ('Activ' cu majusculă, când regula cere 'activ').
Atenție: condiția trece dacă rezultatul este NULL. CHECK (pret >= 0) acceptă pret = NULL; pentru valoare obligatorie adaugă NOT NULL.
De ce apare: cauzele frecvente
1Valoare în afara limitelor
INSERT INTO cursuri (titlu, pret) VALUES ('SQL avansat', -50);INSERT INTO cursuri (titlu, pret) VALUES ('SQL avansat', 450);Regula CHECK (pret >= 0) refuză prețurile negative.
2UPDATE care scade sub limită
UPDATE stoc SET cantitate = cantitate - 5 WHERE produs_id = 4;UPDATE stoc SET cantitate = cantitate - 5
WHERE produs_id = 4 AND cantitate >= 5;Dacă stocul e mai mic decât 5, rezultatul ar fi negativ și CHECK (cantitate >= 0) ar refuza modificarea. Condiția din WHERE modifică doar rândurile care au suficient stoc.
3Text care nu e în lista permisă
INSERT INTO inscrieri (elev, status) VALUES ('Ana', 'Activ');INSERT INTO inscrieri (elev, status) VALUES ('Ana', 'activ');CHECK (status IN ('activ', 'retras')) compară textul exact, cu tot cu litere mari și mici.
Repară eroarea, direct în pagină
Scriptul înregistrează o retragere de 900 de lei din contul 2 (Ana Vasile, sold 800), dar regula CHECK (sold >= 0) refuză soldul negativ. Rescrie UPDATE-ul astfel încât retragerea să se facă doar dacă soldul e suficient (altfel nu se schimbă nimic). Se afișează apoi titular și sold, ordonate după id.
UPDATE conturi
SET sold = sold - 900
WHERE id = 2;
SELECT titular, sold FROM conturi ORDER BY id;titular | sold Ion Popa | 2500 Ana Vasile | 800 Paul Nistor | 150
Indiciu
Adaugă în WHERE condiția sold >= 900.
Reparația
UPDATE conturi
SET sold = sold - 900
WHERE id = 2 AND sold >= 900;
SELECT titular, sold FROM conturi ORDER BY id;De ce merge
Soldul Anei e 800, deci retragerea de 900 ar duce contul la -100, iar CHECK (sold >= 0) oprește instrucțiunea cu eroare.
Condiția sold >= 900 din WHERE face ca UPDATE-ul să nu găsească niciun rând de modificat dacă soldul nu ajunge: nu apare nicio eroare, iar soldurile rămân neschimbate. În aplicație poți verifica apoi câte rânduri au fost modificate (changes()) și afișa „fonduri insuficiente”.
Alte forme ale mesajului
CHECK constraint failed: pret_pozitivERROR 3819 (HY000): Check constraint 'pret_pozitiv' is violated.ERROR: new row for relation "cursuri" violates check constraint "cursuri_pret_check"
Cum o eviți pe viitor
Dă nume constrângerilor (CONSTRAINT pret_pozitiv CHECK (pret >= 0)), ca mesajul de eroare să spună clar ce regulă a fost încălcată. Validează datele și în aplicație, ca utilizatorul să primească un mesaj prietenos înainte să ajungă la baza de date. În UPDATE-urile care scad cantități, pune condiția și în WHERE. Constrângerea din baza de date rămâne ultima linie de apărare, chiar dacă aplicația are un bug.
Întrebări frecvente
MySQL ignoră CHECK?
Versiunile MySQL mai vechi de 8.0.16 acceptau sintaxa CHECK, dar nu o aplicau. Din 8.0.16, constrângerile CHECK sunt verificate. SQLite și PostgreSQL le verifică de mult.
Pot adăuga un CHECK la un tabel existent în SQLite?
Nu direct: SQLite nu are ALTER TABLE ... ADD CONSTRAINT. Trebuie să creezi un tabel nou cu constrângerea, să copiezi datele și să înlocuiești tabelul vechi.
Erori înrudite
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. 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. FOREIGN KEY constraint failed Rândul inserat sau modificat trimite la un rând părinte care nu există (de exemplu o carte cu autor_id = 9, dar nu există autorul 9), sau încerci să ștergi un părinte care mai are copii. Folosește un id existent, creează întâi părintele sau șterge întâi rândurile copil (ori declară ON DELETE CASCADE). Î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.
