ERROR: null value in column "email" of relation "clienti" violates not-null constraint
Un INSERT sau UPDATE lasă fără valoare (NULL) o coloană declarată NOT NULL. De obicei coloana a fost omisă din lista INSERT și nu are DEFAULT, sau aplicația trimite NULL. Completează valoarea, adaugă un DEFAULT potrivit sau, dacă valoarea lipsă e legitimă, scoate constrângerea.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul numește coloana și tabelul, iar DETAIL: Failing row contains (...) arată rândul complet care s-a încercat, util pentru a vedea ce lipsește. O coloană NOT NULL fără DEFAULT trebuie completată la fiecare INSERT; dacă o omiți din listă, primește NULL și constrângerea o respinge.
Cauze frecvente: o coloană nouă adăugată ca NOT NULL în tabel, dar nu și în codul care inserează; INSERT ... SELECT dintr-o sursă cu valori lipsă; un LEFT JOIN care aduce NULL pentru rândurile fără corespondent; un UPDATE care setează o coloană dintr-o subinterogare fără rezultat. Soluția corectă depinde de sens: dacă există o valoare implicită naturală (data creării, stoc 0), pune DEFAULT; dacă nu, valoarea trebuie furnizată, iar eroarea și-a făcut treaba.
De ce apare: cauzele frecvente
1Coloană omisă din INSERT
INSERT INTO clienti (id, nume) VALUES (4, 'Radu Stan');INSERT INTO clienti (id, nume, email) VALUES (4, 'Radu Stan', 'radu@exemplu.ro');Coloana obligatorie trebuie completată.
2Valoare implicită lipsă
ALTER TABLE produse ADD COLUMN creat timestamptz NOT NULL;ALTER TABLE produse ADD COLUMN creat timestamptz NOT NULL DEFAULT now();DEFAULT completează automat coloana la inserare.
3Subinterogare fără rezultat în UPDATE
UPDATE comenzi SET client_id = (SELECT id FROM clienti WHERE email = 'nu@exista.ro');UPDATE comenzi SET client_id = c.id FROM clienti c WHERE c.email = 'nu@exista.ro';Cu UPDATE ... FROM, rândurile fără corespondent nu sunt modificate.
Repară eroarea, direct în pagină
Formularul de înregistrare inserează clientul nou fără email, iar operația dă null value in column "email" of relation "clienti" violates not-null constraint. Completează INSERT-ul cu emailul radu@exemplu.ro și afișează id-ul, numele și emailul clientului 4.
INSERT INTO clienti (id, nume) VALUES (4, 'Radu Stan');
SELECT id, nume, email FROM clienti WHERE id = 4;INSERT 0 1 id | nume | email ----+-----------+----------------- 4 | Radu Stan | radu@exemplu.ro (1 rând)
Indiciu
Adaugă coloana email în listă și valoarea ei.
Reparația
INSERT INTO clienti (id, nume, email) VALUES (4, 'Radu Stan', 'radu@exemplu.ro');
SELECT id, nume, email FROM clienti WHERE id = 4;De ce merge
Coloana email este NOT NULL și nu are valoare implicită, deci omiterea ei din INSERT o lasă NULL, iar constrângerea respinge rândul. Cu emailul inclus în lista de coloane și în valori, rândul este complet. Orașul poate lipsi, pentru că acea coloană acceptă NULL.
Cum o eviți pe viitor
- Pune
DEFAULTpe coloaneleNOT NULLcare au o valoare naturală (timpi, stări inițiale, cantități 0). - Scrie mereu lista explicită de coloane în INSERT.
- Validează câmpurile obligatorii în aplicație, înainte de baza de date.
- Când adaugi o coloană
NOT NULLîntr-un tabel existent, actualizează în aceeași migrare codul care inserează.
Întrebări frecvente
Textul gol încalcă NOT NULL?
Nu: '' este o valoare. Pentru a interzice și textul gol, adaugi CHECK (email <> '').
Cum adaug NOT NULL pe o coloană care are deja NULL-uri?
Completezi întâi valorile lipsă cu un UPDATE, apoi rulezi ALTER COLUMN ... SET NOT NULL. Altfel apare eroarea „column contains null values”.
Erori înrudite
ERROR: column "telefon" of relation "clienti" contains null values Încerci să faci o coloană NOT NULL (ALTER COLUMN ... SET NOT NULL sau ADD COLUMN ... NOT NULL fără DEFAULT), dar unele rânduri existente au NULL în ea. Completează întâi valorile lipsă cu un UPDATE sau adaugă coloana cu un DEFAULT. ERROR: new row for relation "produse" violates check constraint "produse_pret_check" 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. ERROR: INSERT has more target columns than expressions Ai enumerat în INSERT mai multe coloane decât valori în VALUES (sau decât coloane în SELECT). Adaugă valoarea lipsă, scoate coloana din listă dacă vrei valoarea implicită, sau scrie explicit DEFAULT. Î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.
