PostgreSQL tabulu sadalīšana (partitioning) sadala vienu loģisku tabulu daudzās fiziskās tabulās, ko sauc par partīcijām, pēc atslēgas, piemēram, datuma. Lietotnes joprojām vaicā vienu tabulu, un PostgreSQL novirza rindas un vaicājumus uz pareizajām partīcijām. Vairāku terabaitu notikumu vai audita tabulā tā bieži ir atšķirība starp nakts DELETE, kas ilgst stundām, un DROP TABLE, kas aizņem sekundi.
Tomēr tā nav vispārēja paātrināšana. Sadalīšana pievieno plānošanas darbu un nosaka stingrus ierobežojumus unikāliem ierobežojumiem. Šī rokasgrāmata aptver, kad tā ir vērta, kā izvēlēties atslēgu, kā to uzturēt ikdienā bez gariem bloķējumiem un kā pārveidot tabulu, kurā jau ir miljardiem rindu.
Kad sadalīšana ir vērta
PostgreSQL dokumentācija dod īkšķa likumu: ieguvumi parasti ir vērti tikai tad, ja tabula citādi būtu ļoti liela, aptuveni tad, kad tā pārsniedz servera fizisko atmiņu. Mūsu pieredzē īstie iemesli ir konkrētāki:
- Datu glabāšanas termiņš. Jūs glabājat 13 mēnešu datus un katru mēnesi dzēšat vecāko mēnesi. Partīcijas dzēšana ļauj izvairīties no milzīgā
DELETE, tā radītā WAL un atstātās uzpūšanās. - Lielākā daļa vaicājumu skar jaunākos datus. Ja gandrīz katrs vaicājums filtrē pēc pēdējās dienas vai nedēļas, aktīvās partīcijas un to indeksi paliek atmiņā, bet vecās atrodas uz diska.
- Vienas milzīgas tabulas uzturēšana sāp. Vacuum, indeksu pārbūve un pret-wraparound darbs notiek katrai partīcijai atsevišķi, tāpēc katrs palaidiens ir mazāks un var pabeigties. Kāpēc lielās tabulas cieš, skaidrojam mūsu autovacuum regulēšanas rokasgrāmatā.
Ja neviens no šiem neattiecas, labi indeksēta viena tabula parasti ir vienkāršāka un tikpat ātra.
Sadalīšanas atslēgas un metodes izvēle
PostgreSQL atbalsta trīs metodes. Range sadala pēc intervāliem, gandrīz vienmēr laika. List sadala pēc konkrētām vērtībām, piemēram, reģiona vai klientu grupas. Hash izkliedē rindas pēc moduļa un atlikuma, ja dabiska diapazona nav, bet vajag mazākas daļas.
Atslēgai jābūt lielākās daļas vaicājumu WHERE nosacījumā. Partīciju atlase (partition pruning) darbojas tikai tad, ja plānotājs vai izpildītājs no vaicājuma var noteikt, kuras partīcijas ir svarīgas. Vaicājumam, kas nefiltrē pēc atslēgas, jāpārskata katra partīcija, un ar simtiem partīciju tas ir lēnāk nekā viena liela tabula.
CREATE SEQUENCE events_id_seq;
CREATE TABLE events (
id bigint NOT NULL DEFAULT nextval('events_id_seq'),
created_at timestamptz NOT NULL,
account_id bigint NOT NULL,
payload jsonb
) PARTITION BY RANGE (created_at);
CREATE TABLE events_2026_11 PARTITION OF events
FOR VALUES FROM ('2026-11-01') TO ('2026-12-01');
CREATE TABLE events_2026_12 PARTITION OF events
FOR VALUES FROM ('2026-12-01') TO ('2027-01-01');
CREATE INDEX ON events (account_id, created_at);
Diapazona robežas ir iekļaujošas apakšējā galā un neiekļaujošas augšējā, tāpēc '2026-12-01' pieder decembra partīcijai. Indekss, kas izveidots uz vecāktabulas, automātiski tiek izveidots katrā partīcijā. Šeit izmantojam parastu sekvences noklusējumu, jo identity kolonnas sadalītās tabulās ir atļautas tikai kopš PostgreSQL 17.
PRIMARY KEY (id) nav iespējams tabulā, kas sadalīta pēc created_at; tai jābūt (id, created_at). PostgreSQL tad nodrošina pāra unikalitāti, nevis tikai id. Laikus izlemiet, vai jums pietiek ar sekvences ģenerētu id, vai lietotnei jāmeklē rindas pēc id, nezinot datumu.Partīciju izveide, nebloķējot tabulu
CREATE TABLE ... PARTITION OF ņem ACCESS EXCLUSIVE bloķējumu uz vecāktabulas. Noslogotā tabulā tas var nostādīt rindā katru vaicājumu aiz vienas garas transakcijas. Dokumentācija apraksta saudzīgāku ceļu: izveidojiet tabulu atsevišķi, pievienojiet CHECK ierobežojumu, kas atbilst partīcijas robežām, un tad pievienojiet to. ATTACH PARTITION vajag tikai SHARE UPDATE EXCLUSIVE uz vecāktabulas, un atbilstošais ierobežojums ļauj PostgreSQL izlaist pārbaudes skenējumu.
-- Create next month's partition as a plain table first
CREATE TABLE events_2027_01 (LIKE events INCLUDING DEFAULTS);
ALTER TABLE events_2027_01 ADD CONSTRAINT events_2027_01_range
CHECK (created_at >= '2027-01-01' AND created_at < '2027-02-01');
-- Attach: SHARE UPDATE EXCLUSIVE on the parent, no validation scan
SET lock_timeout = '5s';
ALTER TABLE events ATTACH PARTITION events_2027_01
FOR VALUES FROM ('2027-01-01') TO ('2027-02-01');
ALTER TABLE events_2027_01 DROP CONSTRAINT events_2027_01_range;
Veidojiet partīcijas dienas vai nedēļas pirms tās vajadzīgas, nevis pusnaktī, kad pienāk pirmā rinda. Bez atbilstošas partīcijas ieraksts neizdodas ar kļūdu. Rīki, piemēram, pg_partman, to automatizē; lai ko jūs izmantotu, brīdiniet, ja jaunākā partīcija ir mazāk nekā dažas dienas uz priekšu.
Esiet uzmanīgi ar DEFAULT partīciju. Tā uztver rindas, kas neder nekur citur, un tas izklausās droši, bet jaunas partīcijas pievienošanai tad jāskenē noklusējuma partīcija zem ACCESS EXCLUSIVE bloķējuma, ja vien CHECK ierobežojums neizslēdz jauno diapazonu. Tā arī bloķē DETACH ... CONCURRENTLY, kas nav atļauts, ja tabulai ir noklusējuma partīcija. Mēs dodam priekšroku partīciju savlaicīgai izveidei un brīdinājumiem, bet noklusējuma partīciju turam tukšu vai neveidojam vispār.
Indeksi sadalītā tabulā
CREATE INDEX uz vecāktabulas nevar izmantot CONCURRENTLY, tāpēc lielā tabulā tas bloķētu rakstīšanu visu būvēšanas laiku. Dokumentētais risinājums ir izveidot vecāktabulas indeksu ar ON ONLY, katras partīcijas indeksu būvēt konkurenti un tos pievienot:
CREATE INDEX events_payload_idx ON ONLY events USING gin (payload);
CREATE INDEX CONCURRENTLY events_2026_11_payload_idx
ON events_2026_11 USING gin (payload);
ALTER INDEX events_payload_idx ATTACH PARTITION events_2026_11_payload_idx;
-- repeat per partition; the parent index becomes valid when all are attached
Vecāktabulas indekss paliek nederīgs, līdz katrai partīcijai ir pievienots indekss, un tad PostgreSQL to automātiski atzīmē kā derīgu.
Veco datu dzēšana
Šeit sadalīšana atmaksājas. Kopš PostgreSQL 14 partīciju var atvienot, nebloķējot vaicājumus uz vecāktabulas:
ALTER TABLE events DETACH PARTITION events_2025_10 CONCURRENTLY;
-- archive it if needed (pg_dump -t events_2025_10), then:
DROP TABLE events_2025_10;
DETACH ... CONCURRENTLY nevar palaist transakcijas blokā. Ja tas tiek pārtraukts, pabeidziet to ar DETACH PARTITION ... FINALIZE. Dokumentācija norāda, ka vienā tabulā vienlaikus atvienošanu var gaidīt tikai viena partīcija.
Esošas lielas tabulas pārveidošana
PostgreSQL nevar pārvērst parastu tabulu par sadalītu uz vietas. Tomēr esošu tabulu var pievienot kā partīciju. Tas dod praktisku ceļu darbojošai tabulai, iepriekš nekopējot miljardiem rindu:
- Izveidojiet jauno sadalīto tabulu
events_newar tām pašām kolonnām un nākotnes partīcijām, sākot no pārslēgšanas datuma. - Izveidojiet uz vecāktabulas indeksus, kas atbilst vecās tabulas esošajiem indeksiem. Pievienojot dokumentācija saka, ka derīgs līdzvērtīgs indekss partīcijā tiek izmantots atkārtoti; citādi tiek būvēts jauns, ko milzīgā tabulā jūs nevēlaties.
- Pievienojiet vecajai tabulai
CHECKierobežojumu, kas pierāda tās diapazonu, vispirms kāNOT VALID, tad validējiet to. Validācija skenē tabulu, bet nebloķē lasīšanu un rakstīšanu. - Vienā īsā transakcijā ar zemu
lock_timeoutpārdēvējiet tabulas un pievienojiet veco kā vienu lielu partīciju.
-- 1. Prove the range on the old table without blocking writes
ALTER TABLE events_legacy ADD CONSTRAINT events_legacy_range
CHECK (created_at IS NOT NULL AND created_at < '2026-12-01') NOT VALID;
ALTER TABLE events_legacy VALIDATE CONSTRAINT events_legacy_range;
-- 2. Short switch: rename, attach the old table as one big partition
BEGIN;
SET LOCAL lock_timeout = '5s';
ALTER TABLE events_legacy RENAME TO events_old;
ALTER TABLE events_new RENAME TO events;
ALTER TABLE events ATTACH PARTITION events_old
FOR VALUES FROM (MINVALUE) TO ('2026-12-01');
COMMIT;
Jaunās rindas tagad nonāk mēneša partīcijās, un vecā tabula izzūd kā viens bloks, kad tās dati pārsniedz glabāšanas termiņu. Vispirms pārbaudiet detaļas uz kopijas: uzmanību prasa sekvenču piederība un kolonnu noklusējumi, ārējās atslēgas, kas norāda uz tabulu (dokumentācija saka, ka pievienojot tās netiek ņemtas vērā), skati un tiesības. Vispārējo īsu bloķējumu logu tehniku aprakstām mūsu rokasgrāmatā par migrācijām bez dīkstāves.
Kas mainās lielās datubāzēs
- Partīciju skaits ir reāls limits. Dokumentācija saka, ka plānotājs diezgan labi tiek galā ar līdz dažiem tūkstošiem partīciju, ja tipiski vaicājumi atlasa tikai dažas. Pārāk daudz partīciju nozīmē ilgāku plānošanu un vairāk atmiņas katram vaicājumam. Dienas partīcijas, kas glabātas desmit gadus, ir 3650 tabulas; mēneša būtu 120.
- Vecāktabulas statistikai vajag manuālu aprūpi. Saskaņā ar vacuum dokumentāciju autovacuum neapstrādā sadalītās tabulas un nepalaiž tām
ANALYZE. Partīcijas tiek analizētas parasti, bet plāni, kas izmanto visas tabulas statistiku, var ciest. PalaidietANALYZEuz vecāktabulas pēc lielām ielādēm un pēc grafika. - Vaicājumi bez atslēgas kļūst sliktāki. Pirms sadalīšanas pārskatiet savus galvenos vaicājumus
pg_stat_statements. Viss, kas meklē tikai pēcid, skenēs indeksu katrā partīcijā. - Bloķējumi joprojām ir svarīgi. Pievienošana, atvienošana un partīciju izveide visas kaut kur ņem bloķējumus. Palaidiet tās ar zemu
lock_timeoutun atkārtošanas loģiku un vispirms pārbaudiet garās transakcijas. - Vecās partīcijas kļūst lēti glabājamas. Kad veca partīcija vairs nemainās un ir izvakuumēta un iesaldēta, tās uzturēšana maksā maz. Lielas arhīva partīcijas var pat pārvietot uz lētāku krātuvi ar tablespace, ja jūsu sistēma to atbalsta.
- Testējiet pārveidošanu no sākuma līdz beigām. Vairāku terabaitu tabulās
VALIDATE CONSTRAINTskenējums vien var ilgt stundas. Izmēriet to uz atjaunotas kopijas kopā ar pārdēvēšanu un pievienošanu, pirms plānojat produkciju.
Galvenās atziņas
- Sadaliet, ja tabula ir ļoti liela un jums ir glabāšanas termiņš, uz laiku orientēti vaicājumi vai uzturēšanas problēmas, nevis pēc noklusējuma.
- Izvēlieties atslēgu, kas ir lielākajā daļā
WHEREnosacījumu; vaicājumi bez tās skar katru partīciju. - Primārajām atslēgām un unikāliem ierobežojumiem jāietver sadalīšanas atslēga.
- Veidojiet partīcijas laikus ar
CHECKunATTACHun nepaļaujieties uz noklusējuma partīciju. - Vecos datus dzēsiet ar
DETACH ... CONCURRENTLYunDROP TABLE, nevisDELETE. - Darbojošos tabulu pārveidojiet, pievienojot to kā vienu lielu partīciju pēc validēta
CHECKierobežojuma un atbilstošiem indeksiem. - Palaidiet
ANALYZEuz vecāktabulas paši; autovacuum to nedarīs.