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

ERROR: null value in column "email" of relation "clienti" violates not-null constraint

Pe scurt

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

Greșit
SQL
INSERT INTO clienti (id, nume) VALUES (4, 'Radu Stan');
Corect
SQL
INSERT INTO clienti (id, nume, email) VALUES (4, 'Radu Stan', 'radu@exemplu.ro');

Coloana obligatorie trebuie completată.

2Valoare implicită lipsă

Greșit
SQL
ALTER TABLE produse ADD COLUMN creat timestamptz NOT NULL;
Corect
SQL
ALTER TABLE produse ADD COLUMN creat timestamptz NOT NULL DEFAULT now();

DEFAULT completează automat coloana la inserare.

3Subinterogare fără rezultat în UPDATE

Greșit
SQL
UPDATE comenzi SET client_id = (SELECT id FROM clienti WHERE email = 'nu@exista.ro');
Corect
SQL
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ă tu

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.

Codul care dă eroarea
SQL
INSERT INTO clienti (id, nume) VALUES (4, 'Radu Stan');
SELECT id, nume, email FROM clienti WHERE id = 4;
După reparație, programul afișează
INSERT 0 1
 id |   nume    |      email
----+-----------+-----------------
  4 | Radu Stan | radu@exemplu.ro
(1 rând)
Indiciu

Adaugă coloana email în listă și valoarea ei.

Cum o eviți pe viitor

  • Pune DEFAULT pe coloanele NOT NULL care 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

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