這篇涵蓋 partition 的價值來自的兩個機制（planner pruning 與縮小 maintenance scope）、partition key 怎麼選，以及 ATTACH、DETACH 與 partition 數量的維運。

Partition 不是「把大表切小」、是「讓 planner pruning + 縮小 maintenance scope」

只為了「表太大、切小一點」而 partition，得到的是：query 變慢（WHERE 不含 partition key 時 planner 要看所有 partition）、INSERT 變慢（每一列要先 routing 到對應的 partition）、backup 沒變短（總資料量沒變）。partition 的工程價值來自下面兩個機制、跟「切小」沒直接關係：

  1. Query planner pruning：planner 在 planning 階段 跳過 不可能命中 partition key 的 partition、查詢只 scan 相關 partition；前提是 WHERE 條件含 partition key、否則 planner 看完所有 partition、效能反而比單表差
  2. Maintenance scope 縮小：vacuum / index rebuild / DROP / archive 只動單一 partition、不掃整表；vacuum 12 小時變 30 分鐘 / DROP 老資料 0.01 秒、是 partition 真正回本的地方

partition 是 為了 maintenance 跟 planner pruning 設計、不是「表變小」設計。漏掉這個 framing、partition 配置會錯。

RANGE / LIST / HASH：partition 策略對應業務形狀

 1-- RANGE: 時間序列、log、event（最常見）
 2CREATE TABLE events (
 3  id bigint,
 4  event_time timestamptz NOT NULL,
 5  payload jsonb
 6) PARTITION BY RANGE (event_time);
 7
 8CREATE TABLE events_2026_05 PARTITION OF events
 9  FOR VALUES FROM ('2026-05-01') TO ('2026-06-01');
10
11-- LIST: tenant ID / region / status enum
12CREATE TABLE orders (
13  id bigint,
14  tenant_id int NOT NULL,
15  ...
16) PARTITION BY LIST (tenant_id);
17
18CREATE TABLE orders_tenant_premium PARTITION OF orders
19  FOR VALUES IN (1001, 1002, 1003);
20
21-- HASH: 均勻散落（無自然 partition key）
22CREATE TABLE users (
23  user_id bigint NOT NULL,
24  ...
25) PARTITION BY HASH (user_id);
26
27CREATE TABLE users_0 PARTITION OF users
28  FOR VALUES WITH (MODULUS 4, REMAINDER 0);

策略選擇關鍵：

  • RANGE 適合 時間 / 有序值 — query 多半帶 WHERE event_time >= X、prune 效率最高；archive / drop 老資料是對那個 partition 跑 DETACH PARTITION 再 DROP TABLE（見下方 DETACH 那一段的完整流程），0.01 秒量級
  • LIST 適合 離散 enum / tenant — query 帶 WHERE tenant_id = X prune；缺點是每加一批 tenant 都要手動 CREATE TABLE ... PARTITION OF orders FOR VALUES IN (...) 建新 partition
  • HASH 適合 均勻分散、沒自然 key — query 多半 by-PK lookup、HASH 讓單 partition 大小均勻；prune 只在 WHERE hash_key = X 等值查詢觸發

選錯 partition key 是最常見的錯誤

例：events 表用 user_id HASH partition、但 query 多半 WHERE event_time BETWEEN ...、user_id 不在 WHERE — planner 沒法 prune、掃所有 partition、效能比單表更差（多了 partition routing overhead）。

partition key 必須 對應 query 最常用的 WHERE filter；錯了就退化成 維護面有好處、查詢面有壞處 的尷尬狀態。

Partition pruning：planner 怎麼決定跳過

 1EXPLAIN (ANALYZE, BUFFERS)
 2SELECT * FROM events
 3WHERE event_time >= '2026-05-01' AND event_time < '2026-05-15';
 4
 5-- 只剩一個 partition 時，planner 連 Append 都省掉，直接 scan 那一個 partition：
 6--  Seq Scan on events_2026_05 events
 7--    Filter: ((event_time >= ...) AND (event_time < ...))
 8-- 範圍跨兩個月（例如 >= '2026-04-20'）時才出現 Append，底下只列命中的兩個 partition：
 9--  Append
10--    ->  Seq Scan on events_2026_04 events_1
11--    ->  Seq Scan on events_2026_05 events_2

pruning 觸發條件：

  1. WHERE 含 partition key 的 constant expression（WHERE x = 5 觸發；WHERE x = some_function() 不觸發 planning-time prune、但 PG 11+ execution-time prune 可救）
  2. PG 11+ 支援 execution-time pruning — query plan 內含 partition key、runtime 才知道值（prepared statement / NestedLoop join）
  3. partition key 不在 WHERE 時 — 全部 partition 掃、是反指標、表示 partition strategy 不對

Partition-wise join / aggregate (PG 11+)

1SET enable_partitionwise_join = on;
2SET enable_partitionwise_aggregate = on;
3
4-- 兩個同 partition 策略的表 JOIN 時、planner 可 partition-wise 平行做
5SELECT * FROM events e JOIN events_metadata m
6  ON e.event_time = m.event_time
7  WHERE e.event_time >= '2026-05-01';

需要兩個表 partition strategy 完全一致（同 partition key + 同 partition boundary）— 設計時對齊、後期不容易調整。

Production 故障演練

partition key 選錯，query 變慢

徵兆：partition 後特定查詢從 200ms 變成 2000ms；EXPLAIN 顯示 Append 下面所有 partition 都被 scan、沒 partition 被 prune。

根因：partition by user_id HASH、但 query 多用 WHERE created_at BETWEEN X AND Y；planner 不知道 user 在哪個 partition、必須掃全部。

修法：

  1. 驗證 step：partition 前先 pg_stat_statements 看 top 10 query 的 WHERE pattern、partition key 必須對應其中 80% 流量的 filter
  2. 修正：DROP partition strategy、改 partition by created_at RANGE；遷移用 pg_dump --section=data per-partition 重灌
  3. 避免：partitioning 不可逆、設計階段 query pattern 沒看清楚不要動

cross-partition unique constraint 不 enforce

徵兆：partition 後發現 application code 寫死 duplicate user_email、但 unique constraint 沒擋；DB 內有同 email 多筆。

根因：PostgreSQL partition table 的 UNIQUE constraint 必須包含 partition key — UNIQUE (email) 在 partition by tenant_id 的表上 無法 enforce（PostgreSQL 拒建）；workaround 用 UNIQUE (email, tenant_id)、但業務語意是「email 全域唯一」、PG 無法保證。

修法：

  1. 架構：跨 partition 唯一性必須在 application 層 enforce（lock + check 模式）
  2. 替代：用 non-partitioned 表存唯一性目標（user_email_registry）、做寫入前 lookup
  3. 設計階段檢查：partition by X、unique constraint 必須含 X；若業務要求 unique 不含 X、partition strategy 錯

ATTACH PARTITION 的 lock 持有太久

徵兆：新 month partition ATTACH PARTITION 跑 30 秒，期間同一張 events 表上的其他 DDL 與 VACUUM 都在排隊。

根因：PG 12 起，ATTACH PARTITION 對 parent table 拿 SHARE UPDATE EXCLUSIVE（parent 的讀寫照常進行），對被 attach 的表拿 ACCESS EXCLUSIVE；被 attach 的表沒有預先驗證過、涵蓋 partition 範圍的 CHECK constraint 時，ATTACH 要掃完整張表確認每一列都落在範圍內，大 partition 的 lock 持有時間因此拉長。SHARE UPDATE EXCLUSIVE 與自己互斥，所以這段期間 parent 上的其他 ATTACH / DETACH 與 VACUUM 都要等。

修法：

 1-- 1. 先把要 attach 的 partition 加 CHECK constraint，用 NOT VALID 不掃描
 2ALTER TABLE events_2026_06 ADD CONSTRAINT events_2026_06_range
 3  CHECK (event_time >= '2026-06-01' AND event_time < '2026-07-01') NOT VALID;
 4
 5-- 2. VALIDATE 用 SHARE UPDATE EXCLUSIVE lock、允許讀寫
 6ALTER TABLE events_2026_06 VALIDATE CONSTRAINT events_2026_06_range;
 7
 8-- 3. ATTACH 不再需要 scan（CHECK 已 VALIDATE 過）
 9ALTER TABLE events ATTACH PARTITION events_2026_06
10  FOR VALUES FROM ('2026-06-01') TO ('2026-07-01');
11-- ATTACH 變 instant

partition 數爆炸，planner planning time 爆

徵兆：partition 累積到 500+（daily partition 跑 1-2 年）、簡單 query EXPLAIN 顯示 planning_time 從 1ms 漲到 200ms、application response 變慢。

根因：partition 越多 planner 要評估的 partition 越多、即使有 pruning、planning 階段也要 walk 全部 partition table；500+ partition 是 planning overhead 明顯的閾值。

修法：

  1. 架構：partition granularity 對應 retention — 不要 daily partition 留 2 年（→ weekly / monthly）
  2. archive 老 partition：DETACH 老 partition、轉成 cold storage 表、planner 不再看
  3. enable_partition_pruning 預設 on、確保啟用
  4. PG 12+：planner 對 partition table 的 list 處理優化、planning time 上限拉高、但仍要控

DETACH 後磁碟空間沒回收

徵兆：DETACH PARTITION 後 pg_database_size 沒下降、預期釋放 50GB；磁碟仍滿。

根因：DETACH 只是把 partition 從 parent table 分離、partition 自己仍是獨立表存在；要真釋放需要 DROP TABLE detached_partition。SRE 以為 DETACH = 刪掉。

修法：

1-- 完整流程
2ALTER TABLE events DETACH PARTITION events_2024_01;
3-- events_2024_01 仍存在、佔磁碟
4
5-- 確認沒 query 在用後
6DROP TABLE events_2024_01;
7-- 才釋放磁碟

Routine：archive workflow

1-- 月底跑：
2-- 1. detach 13 個月前的 partition
3ALTER TABLE events DETACH PARTITION events_2025_04;
4
5-- 2. dump 到 cold storage
6\COPY events_2025_04 TO '/cold/events_2025_04.csv' (FORMAT CSV);
7
8-- 3. drop 釋放磁碟
9DROP TABLE events_2025_04;

容量規劃

維度估算警戒
單 partition size跟單表 vacuum 上限對齊（10-100GB sweet spot）> 200GB 時考慮 sub-partition 或細化 granularity
Partition 數量對應 retention × granularity> 200 partition 時 planning time 開始浮現
Partition key cardinalityLIST：< 100 / HASH：自定 modulus / RANGE：時間 + 維度太多獨立 partition value 用 HASH
Cross-partition query 比例EXPLAIN 看 partition scan 數> 30% query 掃 > 50% partition 表示 key 選錯
Maintenance windowDROP / DETACH / ATTACH 各 partition 各自管hot partition 維護仍在 maintenance window

實務 default：

  • 時間序列（events / log）：monthly RANGE partition、retention 12-24 個月
  • Multi-tenant（orders / records）：tenant_id LIST partition + 大 tenant 各自獨立 partition
  • 均勻散落（user / metric）：8-16 個 HASH partition、單 partition 50-100GB

整合 / 下一步

跟 autovacuum tuning 整合

partitioning 是 autovacuum 問題的長期解：

  1. Hot partition autovacuum 緊（scale_factor 0.05、cost_limit 5000）
  2. Cold partition autovacuum_enabled = false
  3. 但 partition 數爆會把 autovacuum_max_workers 跑滿、需要拉

跟 index 設計整合

partition table 的 index 處理：

  1. PG 11+ partitioned index：CREATE INDEX ON partitioned_table (...) 在 parent 上建一個 partitioned index，並自動在每個 partition 建 local index；PostgreSQL 沒有跨 partition 的全域 index
  2. 不存在跨 partition unique — 只能 partition-local
  3. partition-wise index scan：PG 11+ 跟 partition-wise join 一起、index lookup 平行

跟 backup / PITR

partition 不是 backup 替代品 — 但能加速 partial restore：

  1. 只 restore 特定時段的 partition、不用 restore 整個表
  2. 對應 PITR + WAL archiving 的 partial recovery scenario

下一步議題

  • Sub-partitioning：partition 內再 partition（時間 + tenant）、適合 multi-tenant + 時間序列
  • pg_partman extension：自動建月 partition、不用 cron
  • Foreign key to partitioned table (PG 12+)：跨 partition FK enforce、但 cascade 限制多

相關連結