ERROR: unique constraint on partitioned table must include all partitioning columns
Pe un tabel partiționat, cheia primară și orice constrângere UNIQUE trebuie să conțină coloana după care partiționezi. Fiecare partiție își verifică unicitatea separat, deci altfel PostgreSQL nu poate garanta unicitatea globală. Adaugă coloana de partiționare în cheie: PRIMARY KEY (id, data).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Indecșii unici pe un tabel partiționat sunt de fapt indecși separați în fiecare partiție. Un id unic într-o partiție poate exista și în alta, iar PostgreSQL nu verifică între partiții. Garanția globală e posibilă doar dacă cheia include coloana de partiționare: atunci două rânduri cu aceeași cheie ajung obligatoriu în aceeași partiție, unde indexul local le prinde. De aceea PRIMARY KEY (id) pe un tabel partiționat după data dă această eroare, cu DETAIL: PRIMARY KEY constraint on table "jurnal" lacks column "data" which is part of the partition key.
Soluția obișnuită este cheia compusă PRIMARY KEY (id, data). Dacă id-ul vine dintr-o secvență sau e un UUID, el rămâne practic unic oricum. Cheile străine din alte tabele trebuie atunci să refere ambele coloane, ceea ce face partiționarea potrivită mai ales pentru tabele de evenimente și jurnale, rar referite.
De ce apare: cauzele frecvente
1Cheie primară fără coloana de partiționare
CREATE TABLE jurnal (id bigint PRIMARY KEY, data date, mesaj text) PARTITION BY RANGE (data);CREATE TABLE jurnal (id bigint, data date, mesaj text, PRIMARY KEY (id, data)) PARTITION BY RANGE (data);Cheia compusă include coloana de partiționare.
2UNIQUE pe un cod
ALTER TABLE jurnal ADD UNIQUE (cod);ALTER TABLE jurnal ADD UNIQUE (cod, data);Aceeași regulă pentru orice constrângere unică.
Repară eroarea, direct în pagină
Tabelul jurnal se partiționează lunar după data, dar id bigint PRIMARY KEY dă unique constraint on partitioned table must include all partitioning columns. Folosește o cheie primară compusă pe (id, data), creează partiția pentru martie 2025, inserează un rând și afișează numele partiției în care a ajuns.
CREATE TABLE jurnal (id bigint PRIMARY KEY, data date NOT NULL, mesaj text) PARTITION BY RANGE (data);
CREATE TABLE jurnal_2025_03 PARTITION OF jurnal FOR VALUES FROM ('2025-03-01') TO ('2025-04-01');
INSERT INTO jurnal VALUES (1, '2025-03-14', 'pornire');
SELECT tableoid::regclass AS partitie, mesaj FROM jurnal;CREATE TABLE
CREATE TABLE
INSERT 0 1
partitie | mesaj
----------------+---------
jurnal_2025_03 | pornire
(1 rând)Indiciu
PRIMARY KEY (id, data)
Reparația
CREATE TABLE jurnal (id bigint, data date NOT NULL, mesaj text, PRIMARY KEY (id, data)) PARTITION BY RANGE (data);
CREATE TABLE jurnal_2025_03 PARTITION OF jurnal FOR VALUES FROM ('2025-03-01') TO ('2025-04-01');
INSERT INTO jurnal VALUES (1, '2025-03-14', 'pornire');
SELECT tableoid::regclass AS partitie, mesaj FROM jurnal;De ce merge
Fiecare partiție are propriul index, deci unicitatea globală a lui id nu poate fi garantată. Cu PRIMARY KEY (id, data), rândurile cu aceeași cheie ajung în aceeași partiție, iar indexul local verifică unicitatea. tableoid::regclass arată că rândul a fost pus în jurnal_2025_03.
Cum o eviți pe viitor
- Alege cheia de partiționare înainte de a proiecta cheile primare.
- Folosește chei compuse care includ coloana de partiționare.
- Partiționează în principal tabelele rar referite prin chei străine (jurnale, evenimente, măsurători).
- Generează id-urile cu o secvență comună sau UUID, ca ele să rămână practic unice între partiții.
Întrebări frecvente
Pot avea un index obișnuit (neunic) doar pe id?
Da. Restricția se aplică doar indecșilor unici și cheilor primare.
De ce nu verifică PostgreSQL unicitatea între partiții?
Ar necesita un index global, pe care PostgreSQL nu îl are; fiecare partiție are propriii indecși.
Erori înrudite
ERROR: no partition of relation "jurnal" found for row Rândul inserat într-un tabel partiționat nu se potrivește cu nicio partiție existentă, de obicei pentru că partiția pentru luna sau anul respectiv nu a fost creată încă. Creează partiția lipsă sau o partiție DEFAULT care să primească rândurile neacoperite. ERROR: could not create unique index "clienti_email_key" Încerci să adaugi o constrângere UNIQUE (sau un index unic, sau o cheie primară) pe o coloană care are deja valori duplicate. DETAIL arată prima pereche duplicată. Găsește și rezolvă duplicatele (șterge, combină sau corectează), apoi creează din nou constrângerea. ERROR: there is no unique constraint matching given keys for referenced table "clienti" O cheie străină referă o coloană (sau un set de coloane) din tabelul părinte care nu are cheie primară sau constrângere UNIQUE. PostgreSQL cere ca valorile referite să fie unice. Adaugă UNIQUE pe coloana referită sau referă cheia primară a tabelului. Î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.
