PostgreSQL 19 REPACK 怎么清理表膨胀

删除了 2000 万行,逻辑行数已经下降,表文件仍超过 100 GB,精确 count(*) 还要约 100 秒,这是 PostgreSQL 表膨胀的典型表现。 确认目标 PostgreSQL 19 小版本支持内置命令后,使用 REPACK TABLE public.orders;;如果走 pg_repack 扩展路径,执行入口则是客户端 pg_repack。两者的参数和限制不能混用。 排查时依次确认版本与命令入口、确认膨胀、检查空间与对象条件,再执行并对比结果。

是否值得重建,不能只看文件大小。普通 VACUUM 能清理死元组、让空间在表内复用,却不会把文件空间归还操作系统;频繁 UPDATE、DELETE 后出现大量死元组和索引膨胀,才适合考虑重写。PG 19 的并行 Autovacuum 主要并行化索引清理,也不能代替文件重写。

REPACK 报错先看版本和执行入口

先查服务器版本和扩展是否存在:

SELECT version();

SELECT extname, extversion
FROM pg_extension
WHERE extname = 'pg_repack';

在 psql 中还可以确认当前连接是否认识内置命令:

\help REPACK

pg_extension 中没有 pg_repack,并不代表 PG 19 的内置 REPACK 不存在;反过来,存在扩展行,也只说明安装了三方扩展。PG 19 内置实现使用 SQL 入口:

-- 先确认目标 PostgreSQL 19 小版本的官方文档支持此语法
REPACK TABLE public.orders;

扩展路径则使用客户端程序。正式执行前先看当前客户端的帮助,并做一次不落地的检查:

pg_repack --help
pg_repack --dry-run --table=public.orders

如果看到 must be superuser to use xxx function,先确认报错来自扩展,而不是内置命令。阿里云文档把这类报错与实例内核小版本或插件版本不匹配联系起来,处理方式是核对实例支持的版本范围和已安装插件版本,而不是直接给业务账号授予超级用户权限。

CONCURRENTLY 也不能从社区补丁讨论直接推断为已发布功能。相关邮件列表仍在讨论实现和锁升级问题,因此是否支持该选项、具体锁语义以及可重写的对象类型,都应以目标 PG 19 小版本的最终官方文档为准。

确认这张表确实该重建

执行前先记录堆表、索引、总大小和死元组:

SELECT
    pg_size_pretty(pg_relation_size('public.orders'::regclass)) AS heap_size,
    pg_size_pretty(pg_total_relation_size('public.orders'::regclass)) AS total_size;

SELECT
    n_live_tup,
    n_dead_tup,
    last_vacuum,
    last_autovacuum,
    last_analyze,
    last_autoanalyze
FROM pg_stat_user_tables
WHERE schemaname = 'public'
  AND relname = 'orders';

SELECT
    indexrelname,
    pg_size_pretty(pg_relation_size(indexrelid)) AS index_size
FROM pg_stat_user_indexes
WHERE schemaname = 'public'
  AND relname = 'orders';

n_live_tup 和 n_dead_tup 是统计估算值,适合用来发现明显异常,不是精确计数。若表文件远大于活行所需空间,同时死元组长期保持高位,重建通常值得考虑;如果死元组很少,就不要急着执行 REPACK,应继续检查索引、TOAST、数据局部性以及慢查询本身。

长事务、失效复制槽和 I/O 压力都可能妨碍旧行版本及时回收,因此还要查看:

SELECT pid, usename, xact_start, state
FROM pg_stat_activity
WHERE xact_start IS NOT NULL
ORDER BY xact_start;

SELECT slot_name, slot_type, active, restart_lsn
FROM pg_replication_slots;

active = false 不等于复制槽已经失效,需要结合托管平台的监控和日志判断。

扩展路径有几项硬限制。没有主键或合格唯一约束的表可能被 pg_repack 拒绝,GiST 索引也不受支持。 阿里云 RDS 对该扩展给出的空间要求是:全表 repack 时,剩余空间至少达到待处理表大小的两倍;这个数字只适用于对应 RDS 环境,不能直接套到 PG 19 内置实现。

锁和 DDL 影响也要分开看。扩展路径大部分阶段允许 DML,但在交换新旧对象时会短暂取得强锁,运行期间不能对目标表执行 DDL;内置实现的最终锁语义不能照搬扩展结论。 还要评估 I/O 压力:阿里云文档给出的案例中,在 ESSD PL1 上 repack 一张 100 GB 表时达到 250 MB/s 的吞吐上限,这只是特定环境下的案例,不是通用性能保证。

确认数据目录所在文件系统仍有足够空间:

SHOW data_directory;
df -h

通过检查后,再执行目标小版本文档确认过的命令,并刷新统计信息:

REPACK TABLE public.orders;

ANALYZE public.orders;

内置命令的权限要求、可重写对象类型和额外空间要求仍以目标小版本官方文档为准;不要把 pg_repack 的客户端选项直接拼到 REPACK TABLE 后面。

执行后用大小、死元组和执行计划验收

命令返回成功不代表清理完成。重新对比堆表、索引和总大小:

SELECT
    pg_size_pretty(pg_relation_size('public.orders'::regclass)) AS heap_size,
    pg_size_pretty(pg_relation_size('public.orders_pkey'::regclass)) AS index_size,
    pg_size_pretty(pg_total_relation_size('public.orders'::regclass)) AS total_size;

索引名应按实际情况修改。pg_total_relation_size 还包含 TOAST 等关联空间,因此堆表已经缩小但总量变化不大时,需要继续拆分检查,而不是直接判定 repack 失败。

再复查死元组和统计信息:

SELECT
    n_live_tup,
    n_dead_tup,
    last_vacuum,
    last_autovacuum,
    last_analyze,
    last_autoanalyze
FROM pg_stat_user_tables
WHERE schemaname = 'public'
  AND relname = 'orders';

n_live_tup 和 n_dead_tup 是异步更新的估算值,不能要求 n_dead_tup 在命令结束后立刻归零;但 last_analyze 应能反映刚才执行的 ANALYZE。如果 repack 期间仍有大量写入,重建后的表也可能马上开始产生新的死元组。

精确行数只在确实需要时执行:

SELECT count(*)
FROM public.orders;

count(*) 会扫描活元组,重写后页数减少通常会改善扫描成本,但它仍然不是常数时间操作;活行本身很多时,慢是正常现象。

最后选取有代表性的真实慢查询,原样放进 EXPLAIN,在相近负载下比较执行计划和缓冲区读取:

EXPLAIN (ANALYZE, BUFFERS)
SELECT ...;  -- 替换成真实的代表性查询

重点看实际耗时、共享块读取和扫描页数,而不只是计划名称。膨胀会增加读取成本,但数据局部性也会影响执行效率,所以不能只凭执行计划从 index scan 变成另一种扫描方式就下结论。

© 版权声明
THE END
喜欢就支持一下吧
点赞0 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容