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

ERROR: update or delete on table "clienti" violates foreign key constraint "comenzi_client_id_fkey" on table "comenzi"

Pe scurt

Încerci să ștergi (sau să schimbi cheia) unui rând părinte care e încă referit din alt tabel, de exemplu un client care are comenzi. Cheia străină implicită (NO ACTION) interzice asta. Șterge sau mută întâi rândurile copil ori definește cheia cu ON DELETE CASCADE sau SET NULL, dacă asta e regula dorită.

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

Ce înseamnă

Cheia străină protejează și direcția inversă: un rând din clienti nu poate dispărea cât timp comenzi are rânduri care îl referă. Mesajul numește tabelul copil și constrângerea, iar DETAIL: Key (id)=(1) is still referenced from table "comenzi". arată valoarea.

Ce faci depinde de regula de business. Dacă rândurile copil nu au sens fără părinte (liniile unei comenzi), ON DELETE CASCADE le șterge automat. Dacă trebuie păstrate (comenzile unui client care își șterge contul), ON DELETE SET NULL sau anonimizarea clientului sunt mai potrivite. Dacă ștergerea nu e permisă deloc, eroarea este comportamentul corect, iar aplicația trebuie să o explice. Comportamentul se schimbă recreând constrângerea: ALTER TABLE ... DROP CONSTRAINT ..., ADD CONSTRAINT ... ON DELETE CASCADE.

De ce apare: cauzele frecvente

1Ștergerea unui client cu comenzi

Greșit
SQL
DELETE FROM clienti WHERE id = 2;
Corect
SQL
DELETE FROM comenzi WHERE client_id = 2;
DELETE FROM clienti WHERE id = 2;

Copiii se șterg explicit, înaintea părintelui.

2Regulă de ștergere în cascadă

Greșit
SQL
CREATE TABLE linii (comanda_id int REFERENCES comenzi(id), ...);
Corect
SQL
CREATE TABLE linii (comanda_id int REFERENCES comenzi(id) ON DELETE CASCADE, ...);

Liniile dispar automat odată cu comanda.

3Schimbarea cheii primare a părintelui

Greșit
SQL
UPDATE clienti SET id = 10 WHERE id = 1;
Corect
SQL
-- evită schimbarea cheilor primare; dacă e necesar:
-- REFERENCES clienti(id) ON UPDATE CASCADE

Cheile primare ar trebui să fie stabile.

Repară tu

Repară eroarea, direct în pagină

Clientul Mihai Ionescu (id 2) a cerut ștergerea contului, iar comenzile lui pot fi șterse. DELETE FROM clienti WHERE id = 2 dă update or delete on table "clienti" violates foreign key constraint. Șterge întâi comenzile clientului, apoi clientul, și afișează numărul de clienți și de comenzi rămase.

Codul care dă eroarea
SQL
DELETE FROM clienti WHERE id = 2;
SELECT (SELECT count(*) FROM clienti) AS clienti, (SELECT count(*) FROM comenzi) AS comenzi;
După reparație, programul afișează
DELETE 1
DELETE 1
 clienti | comenzi
---------+---------
       2 |       2
(1 rând)
Indiciu

Rândurile copil trebuie să dispară înaintea părintelui.

Cum o eviți pe viitor

  • Alege la proiectare regula ON DELETE potrivită pentru fiecare cheie străină: CASCADE, SET NULL sau RESTRICT.
  • Pentru date cu valoare juridică sau contabilă (comenzi, facturi), preferă dezactivarea logică (activ = false) în locul ștergerii.
  • Creează index pe coloana copil, ca verificarea la ștergere să nu scaneze tot tabelul.

Întrebări frecvente

Ce diferență e între NO ACTION și RESTRICT?

RESTRICT verifică imediat, NO ACTION la sfârșitul instrucțiunii (sau la COMMIT, dacă e amânată). În practică diferența contează doar la constrângeri amânabile.

CASCADE e periculos?

Poate fi: o singură ștergere poate elimina multe rânduri din mai multe tabele. Folosește-l doar unde copiii nu au sens fără părinte.

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.