...
Eroare PostgreSQL · Constrângeri, chei și secvențe

ERROR: new row for relation "produse" violates check constraint "produse_pret_check"

Pe scurt

Rândul nou sau modificat nu respectă o constrângere CHECK, de exemplu un preț zero sau negativ când regula cere pret > 0. DETAIL arată rândul complet. Corectează valoarea; dacă regula s-a schimbat, modifică constrângerea, nu o ocoli.

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

Ce înseamnă

O constrângere CHECK este o condiție booleană evaluată pentru fiecare rând nou sau modificat. Dacă rezultatul e false, rândul e respins cu acest mesaj, care numește constrângerea (produse_pret_check este numele generat automat pentru CHECK (pret > 0) pe coloana pret). Dacă rezultatul e NULL, constrângerea trece, deci CHECK (pret > 0) nu interzice un preț NULL; pentru asta există NOT NULL.

Constrângerea apare des la UPDATE-uri în masă: o reducere de 100% sau o scădere de stoc sub zero (CHECK (stoc >= 0)). În acest caz e un semnal util: logica aplicației a încercat ceva imposibil. Dă nume explicite constrângerilor (CONSTRAINT pret_pozitiv CHECK (pret > 0)), ca mesajul să spună clar regula și să poată fi tradus în aplicație.

De ce apare: cauzele frecvente

1Preț invalid

Greșit
SQL
UPDATE produse SET pret = 0 WHERE id = 4;
Corect
SQL
UPDATE produse SET pret = 999.00 WHERE id = 4;

Prețul trebuie să rămână pozitiv.

2Stoc care ar deveni negativ

Greșit
SQL
UPDATE produse SET stoc = stoc - 10 WHERE id = 1;  -- stoc 5
Corect
SQL
UPDATE produse SET stoc = stoc - 10 WHERE id = 1 AND stoc >= 10;

Condiția din WHERE face scăderea doar când e posibilă; zero rânduri modificate înseamnă stoc insuficient.

Repară tu

Repară eroarea, direct în pagină

Scriptul de vânzare scade 10 bucăți din stocul laptopului, dar laptopul are doar 5 bucăți, iar tabelul are CHECK (stoc >= 0). Operația dă violates check constraint "produse_stoc_check". Scrie UPDATE-ul condiționat, care scade stocul doar dacă ajunge, apoi afișează stocul laptopului.

Codul care dă eroarea
SQL
UPDATE produse SET stoc = stoc - 10 WHERE id = 1;
SELECT nume, stoc FROM produse WHERE id = 1;
După reparație, programul afișează
UPDATE 0
    nume     | stoc
-------------+------
 Laptop Nova |    5
(1 rând)
Indiciu

Adaugă condiția stoc >= 10 în WHERE.

Cum o eviți pe viitor

  • Dă nume clare constrângerilor CHECK, ca mesajele să explice singure regula.
  • Folosește UPDATE-uri condiționate (WHERE stoc >= cantitate) pentru operații care pot încălca regulile.
  • Combină CHECK cu NOT NULL când valoarea lipsă nu e permisă.
  • Mapează în aplicație codul SQLSTATE 23514 la mesaje prietenoase.

Întrebări frecvente

Pot folosi o subinterogare într-un CHECK?

Nu. CHECK vede doar rândul curent. Pentru reguli care implică alte rânduri sau tabele, folosești chei străine, constrângeri de excludere sau triggere.

Cum văd definiția constrângerii?

Cu \d produse în psql sau SELECT pg_get_constraintdef(oid) FROM pg_constraint WHERE conname = 'produse_pret_check'.

Erori înrudite

← Toate erorile PostgreSQL

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ță PostgreSQL de la zero, cu exerciții la fiecare lecție

Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.