1002 字
5 分鐘

PostgreSQL 19 REPACK CONCURRENTLY 怎麼用?先查表資格與鎖

本文目錄

PostgreSQL 19 在 2026 年 11 月 19 日正式發布。要在服務仍有流量時回收單張資料表的空間,可以先評估 REPACK (CONCURRENTLY)。它把大部分重寫工作放在較低強度的鎖下,最後交換表和索引檔案時仍會申請獨占鎖。若這張表有長時間的報表快照、持續大量更新,或剩餘空間已經吃緊,先在測試環境量出這些成本,再排維護時段。

普通 REPACK 對應需要重寫、縮小表檔案的維護需求。若還要照索引重排資料,可加上 USING INDEX,對應原本 CLUSTER 的用途。PostgreSQL 19 仍保留 VACUUM FULL 和 CLUSTER。日常讓同一張表重用已刪除列的空間,繼續讓 autovacuum 或一般 VACUUM 處理。PostgreSQL 19 發布公告

還在 18 或更早版本的環境,要先另外規劃主版本升級。依 19 版的升級相容性說明 選擇 pg_upgrade、匯出匯入或邏輯複寫,並在副本驗證應用與擴充套件。以下演練從已啟動的 19.0 開始。

先查這張表能不能並行重寫#

在目標資料庫的主節點上執行這組唯讀查詢,把 public.events 換成實際表名。第一組輸出檢查版本、WAL 層級與 REPACK 專用 slot 上限,第二組列出表類型和可用的列識別依據。

SELECT current_setting('server_version') AS version,
current_setting('wal_level') AS wal_level,
current_setting('max_repack_replication_slots', true) AS repack_slots;
SELECT c.oid::regclass AS relation,
c.relkind,
c.relpersistence,
am.amname AS access_method,
EXISTS (
SELECT 1 FROM pg_index i
WHERE i.indrelid = c.oid AND i.indisprimary
) AS has_primary_key,
c.relreplident AS replica_identity,
EXISTS (
SELECT 1 FROM pg_index i
WHERE i.indrelid = c.oid AND i.indisreplident
) AS has_identity_index
FROM pg_class c
LEFT JOIN pg_am am ON am.oid = c.relam
WHERE c.oid = to_regclass('public.events');

一般永久 heap 表會看到 relkind = r、relpersistence = p、access_method = heap。有主鍵或具備索引式 replica identity 才符合這部分的要求。分割表的父表、UNLOGGED 表與 materialized view 都無法使用並行模式。查不到表時先核對資料庫與 schema。完整條件還包括維護權限、系統表類型及表的 storage parameters,應對照 REPACK 指令文件。

wal_level 需為 replica 或更高,伺服器也要有可用的 REPACK slot。max_repack_replication_slots 的預設是 5,設為 0 會停用這條路徑。SQL 工具如果會自動包 BEGIN,請改用 autocommit 執行並行重寫。複寫設定文件

在隔離資料庫演練換檔和結果驗收#

以下只對測試庫中的專用表操作。它造出可刪除的資料,在重寫前後各量一次表與索引總大小。請使用 PostgreSQL 19 並執行在沒有其他寫入者的測試資料庫。

CREATE TABLE repack_demo (id integer PRIMARY KEY, payload text);
INSERT INTO repack_demo
SELECT n, repeat(md5(n::text), 20)
FROM generate_series(1, 20000) AS n;
DELETE FROM repack_demo WHERE id <= 15000;
SELECT count(*) AS rows, pg_total_relation_size('repack_demo') AS bytes
FROM repack_demo;
REPACK (CONCURRENTLY, VERBOSE) repack_demo;
SELECT count(*) AS rows, pg_total_relation_size('repack_demo') AS bytes
FROM repack_demo;

本機以 PostgreSQL 19.0 執行範例,重寫前後均讀到 5,000 筆,表與索引總大小從 14,163,968 bytes 降到 3,842,048 bytes。數字只描述這組合成資料。正式表應量實際 bytes,刪除列數無法直接換算成可回收容量。正式表有流量時,額外在 staging 保留一筆會更新資料的測試交易,重寫結束後按主鍵核對更新結果,並記錄最後換檔時的鎖等待、請求延遲及磁碟峰值。REPACK 期間要容納新表與索引,以及捕捉並行變更所需的空間。

PostgreSQL 文件也提醒,並行重寫不具 MVCC 安全性。若交易的快照取得於重寫開始之前,在重寫提交後才讀取這張表,可能看到空表。先找出長報表交易與連線池中的 idle in transaction,再決定何時執行。若服務跑在容器內,先從應用實際連到的資料庫執行版本查詢,避免把 Compose 的資料庫就緒檢查 當成版本或維護資格檢查。

參考資料:

PostgreSQL 19 發布公告

PostgreSQL 19:版本說明與升級相容性

PostgreSQL 19:REPACK

PostgreSQL 19:Replication 設定

PostgreSQL 19 REPACK CONCURRENTLY 怎麼用?先查表資格與鎖
https://laplusda.com/posts/postgresql-19-repack-concurrently/
作者
Zero
發佈於
2026-11-20
許可協議
CC BY-NC-SA 4.0