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

ERROR: column "telefon" of relation "clienti" contains null values

Pe scurt

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

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

Ce înseamnă

SET NOT NULL verifică toate rândurile existente. Dacă găsește un singur NULL, refuză cu acest mesaj. Aceeași eroare apare la ADD COLUMN x tip NOT NULL fără DEFAULT pe un tabel cu rânduri: coloana nouă ar fi NULL peste tot, deci constrângerea ar fi încălcată imediat.

Soluțiile: la coloane noi, adaugă un DEFAULT (din PostgreSQL 11, ADD COLUMN ... DEFAULT valoare_constantă e instantaneu, fără rescrierea tabelului). La coloane existente: completează valorile lipsă (UPDATE ... SET telefon = 'necunoscut' WHERE telefon IS NULL sau o valoare calculată), apoi SET NOT NULL. Pe tabele mari, varianta fără blocaj lung este o constrângere CHECK (telefon IS NOT NULL) NOT VALID, validată separat; după validare, SET NOT NULL nu mai scanează tabelul.

De ce apare: cauzele frecvente

1Coloană existentă cu NULL-uri

Greșit
SQL
ALTER TABLE clienti ALTER COLUMN oras SET NOT NULL;
Corect
SQL
UPDATE clienti SET oras = 'Necunoscut' WHERE oras IS NULL;
ALTER TABLE clienti ALTER COLUMN oras SET NOT NULL;

După completare, constrângerea poate fi aplicată.

2Coloană nouă NOT NULL fără valoare implicită

Greșit
SQL
ALTER TABLE clienti ADD COLUMN tara text NOT NULL;
Corect
SQL
ALTER TABLE clienti ADD COLUMN tara text NOT NULL DEFAULT 'RO';

Rândurile existente primesc valoarea implicită.

Repară tu

Repară eroarea, direct în pagină

Orașul clienților devine obligatoriu, dar Elena Dinu nu are oraș, iar ALTER COLUMN oras SET NOT NULL dă column "oras" of relation "clienti" contains null values. Completează orașurile lipsă cu „Necunoscut”, aplică NOT NULL și afișează numele și orașul clienților.

Codul care dă eroarea
SQL
ALTER TABLE clienti ALTER COLUMN oras SET NOT NULL;
SELECT nume, oras FROM clienti ORDER BY id;
După reparație, programul afișează
UPDATE 1
ALTER TABLE
     nume      |    oras
---------------+------------
 Ana Pop       | Cluj
 Mihai Ionescu | Iași
 Elena Dinu    | Necunoscut
(3 rânduri)
Indiciu

UPDATE ... WHERE oras IS NULL, apoi SET NOT NULL.

Cum o eviți pe viitor

  • Adaugă coloanele obligatorii împreună cu un DEFAULT potrivit.
  • Înainte de SET NOT NULL, numără valorile lipsă: SELECT count(*) FROM t WHERE col IS NULL.
  • Pe tabele mari, folosește CHECK (... IS NOT NULL) NOT VALID și VALIDATE înainte de SET NOT NULL.
  • Decide împreună cu echipa de produs ce valoare primesc rândurile vechi.

Întrebări frecvente

Este ADD COLUMN cu DEFAULT lent pe tabele mari?

Nu pentru o valoare constantă: PostgreSQL o păstrează în catalog și nu rescrie tabelul. Un DEFAULT volatil (de exemplu random()) rescrie însă tot tabelul.

Cum găsesc rândurile cu NULL?

SELECT * FROM clienti WHERE oras IS NULL; Atenție: = NULL nu găsește niciodată nimic.

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.