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

ERROR: value for domain email_valid violates check constraint "email_valid_check"

Pe scurt

Coloana are un tip DOMAIN cu o regulă CHECK, iar valoarea nu o respectă, de exemplu un email fără @ într-un domeniu email_valid. Corectează valoarea înainte de inserare; regula se aplică oriunde e folosit domeniul.

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

Ce înseamnă

Un DOMAIN este un tip existent (de obicei text sau numeric) cu reguli adăugate: CREATE DOMAIN email_valid AS text CHECK (VALUE ~ '^[^@\s]+@[^@\s]+\.[^@\s]+$'). Folosit ca tip pentru coloane din mai multe tabele, centralizează validarea. Valorile care nu respectă regula dau această eroare, cu numele domeniului și al constrângerii.

Domeniile sunt verificate la conversia în tipul respectiv, deci și la 'abc'::email_valid, la parametrii funcțiilor și la coloanele din toate tabelele. Avantajul față de CHECK pe fiecare coloană: o modificare a regulii (ALTER DOMAIN ... ADD CONSTRAINT) se aplică peste tot. Datele existente sunt verificate la adăugarea unei constrângeri noi, cu excepția variantei NOT VALID. Regula se testează rapid cu SELECT 'ana@exemplu.ro'::email_valid.

De ce apare: cauzele frecvente

1Email fără domeniu

Greșit
SQL
INSERT INTO abonati VALUES ('ana@');
Corect
SQL
INSERT INTO abonati VALUES ('ana@exemplu.ro');

Valoarea trebuie să respecte expresia regulată a domeniului.

2Spații în plus din formular

Greșit
SQL
INSERT INTO abonati VALUES (' ana@exemplu.ro ');
Corect
SQL
INSERT INTO abonati VALUES (trim(' ana@exemplu.ro '));

Spațiile nu sunt permise de regulă; le elimini înainte.

Repară tu

Repară eroarea, direct în pagină

Tabelul abonati folosește domeniul email_valid, care cere un format de email simplu. Importul a trimis un email cu spații la margini și dă value for domain email_valid violates check constraint. Curăță valoarea cu trim și lower înainte de inserare, apoi afișează emailurile.

Codul care dă eroarea
SQL
INSERT INTO abonati VALUES (' Dan@Exemplu.ro ');
SELECT email FROM abonati ORDER BY email;
După reparație, programul afișează
INSERT 0 1
     email
----------------
 ana@exemplu.ro
 dan@exemplu.ro
(2 rânduri)
Indiciu

lower(trim(' Dan@Exemplu.ro '))

Cum o eviți pe viitor

  • Definește domenii pentru tipurile de date care se repetă (email, cod poștal, procent) și folosește-le în toate tabelele.
  • Normalizează valorile (trim, lower) în aplicație sau într-un trigger înainte de inserare.
  • Testează regula pe exemple reale înainte să o aplici pe date existente.
  • Dă nume explicite constrângerilor domeniului, ca mesajele să fie clare.

Întrebări frecvente

Pot schimba regula unui domeniu folosit deja?

Da: ALTER DOMAIN email_valid DROP CONSTRAINT ... și ADD CONSTRAINT .... Constrângerea nouă e verificată pe toate coloanele care folosesc domeniul.

Domeniile încetinesc inserările?

Doar cât costă evaluarea condiției; pentru o expresie regulată simplă costul e neglijabil.

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.