...
Eroare PostgreSQL · Tabele, view-uri, indecși și partiții

ERROR: unique constraint on partitioned table must include all partitioning columns

Pe scurt

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

Greșit
SQL
CREATE TABLE jurnal (id bigint PRIMARY KEY, data date, mesaj text) PARTITION BY RANGE (data);
Corect
SQL
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

Greșit
SQL
ALTER TABLE jurnal ADD UNIQUE (cod);
Corect
SQL
ALTER TABLE jurnal ADD UNIQUE (cod, data);

Aceeași regulă pentru orice constrângere unică.

Repară tu

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.

Codul care dă eroarea
SQL
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;
După reparație, programul afișează
CREATE TABLE
CREATE TABLE
INSERT 0 1
    partitie    |  mesaj
----------------+---------
 jurnal_2025_03 | pornire
(1 rând)
Indiciu

PRIMARY KEY (id, data)

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

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