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

ERROR: cannot truncate a table referenced in a foreign key constraint

Pe scurt

TRUNCATE golește tabelul instant, fără să verifice rând cu rând, deci nu poate fi folosit pe un tabel referit de chei străine din alt tabel. Golește în aceeași comandă și tabelele care îl referă (TRUNCATE comenzi, clienti) sau folosește TRUNCATE ... CASCADE, conștient de efect.

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

Ce înseamnă

TRUNCATE nu șterge rândurile unul câte unul, ci înlocuiește fișierele tabelului, ceea ce e foarte rapid, dar nu permite verificarea cheilor străine rând cu rând. De aceea PostgreSQL refuză golirea unui tabel referit din alt tabel, cu DETAIL: Table "comenzi" references "clienti". și HINT: Truncate table "comenzi" at the same time, or use TRUNCATE ... CASCADE.

Variantele: TRUNCATE comenzi, clienti golește ambele tabele în aceeași operație, deci nu rămân referințe orfane. TRUNCATE clienti CASCADE golește automat toate tabelele care referă clienti, recursiv, ceea ce poate șterge mai mult decât te aștepți. RESTART IDENTITY resetează și secvențele. Dacă vrei să golești doar părinții fără copii, folosește DELETE, care respectă regulile ON DELETE.

De ce apare: cauzele frecvente

1Golirea părintelui singur

Greșit
SQL
TRUNCATE clienti;
Corect
SQL
TRUNCATE comenzi, clienti RESTART IDENTITY;

Ambele tabele se golesc împreună, iar secvențele se resetează.

2CASCADE fără să știi ce mai șterge

Greșit
SQL
TRUNCATE clienti CASCADE;
Corect
SQL
SELECT conrelid::regclass FROM pg_constraint WHERE confrelid = 'clienti'::regclass;
-- verifici lista, apoi decizi

Afli întâi ce tabele referă clienti.

Repară tu

Repară eroarea, direct în pagină

Scriptul care curăță mediul de test golește tabelul clienti, dar dă cannot truncate a table referenced in a foreign key constraint. Golește în aceeași comandă comenzile și clienții, resetând secvențele, apoi afișează numărul de rânduri din ambele tabele.

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

TRUNCATE comenzi, clienti RESTART IDENTITY

Cum o eviți pe viitor

  • Listează explicit toate tabelele de golit într-un singur TRUNCATE.
  • Folosește CASCADE doar după ce ai verificat ce tabele referă tabelul golit.
  • Pentru curățarea datelor de test, scrie un script care golește tabelele în ordinea dependențelor.
  • Nu rula TRUNCATE pe producție fără backup: operația nu poate fi recuperată după COMMIT.

Întrebări frecvente

TRUNCATE poate fi anulat?

Da, într-o tranzacție deschisă, cu ROLLBACK. După COMMIT, datele sunt pierdute.

De ce e TRUNCATE mai rapid decât DELETE?

Nu scanează rândurile și nu creează versiuni moarte; înlocuiește fișierele tabelului. În schimb, ia un blocaj exclusiv pe tabel.

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.