AI 原生 BaaS 平台 Supabase 版
AI 原生 BaaS 平台 Supabase 版
文档指南
请输入
- 文档首页
AI 原生 BaaS 平台 Supabase 版用户指南PostgreSQL 引擎用户指南插件清理空间（pg_repack）
复制全文
下载 pdf清理空间（pg_repack）
文档反馈
问问助手云数据库 PostgreSQL 版支持通过插件 pg_repack 提供在线 Vacuum Full 的能力，有效解决因为频繁 Update、Delete 等操作引起的表和索引等对象所占据的物理磁盘空间膨胀的问题。相较于 Cluster 和 Vacuum Full，pg_repack 在执行过程中，不会阻塞对目标表的 DML 操作。
原理介绍
pg_repack 支持对全表和索引进行 repack，缩减因 Update、Delete 等操作引起的表和索引等对象所占的磁盘空间。
对全表进行 repack
对全表进行 repack 的实现原理如下：
- 创建日志表记录对原表的变更。
- 在原表创建触发器，将原表的 INSERT、UPDATE 和 DELETE 操作记录到日志表中。
- 创建新表，与原表的行列相同。
- 对新表执行 INSERT INTO SELECT，将原表数据导入新表。
- 在新表中创建和原表一一对应的索引。
- 将日志表里的变更应用到新表。
- 将新表及其索引和 repack 的原表及其索引进行物理文件交换。
- 删除新表和新索引。
- 对目标表执行 ANALYZE，更新统计信息。
在上述步骤中的 1、2、6、7和 8，pg_repack 会短暂持有 ACCESS EXCLUSIVE 锁；在其他步骤中，pg_repack 只需要持有原表的 ACCESS SHARE 锁，不影响原表的 INSERT、UPDATE 和DELETE。
对索引进行 repack
对索引进行 repack 的实现原理如下：
- 以 CONCURRENTLY 方式创建新索引。
- 将新索引和 repack 的目标索引进行物理文件交换。
- 删除旧索引文件。
使用限制
- pg_repack 需配合客户端使用，云数据库 PostgreSQL 版目前支持 pg_repack 1.4.8 和 1.5.2 版本，要求服务端二进制版本与客户端相同。
- pg_repack 需要额外的存储空间。全表 repack 时，剩余存储空间需至少是待 repack 表和待 repack 表所有索引占据的总空间和的 2 倍。
- 如果待 repack 的目标表有主键，且主键索引定义存在 INCLUDE 子句，则被 INCLUDE 的列必须 NOT NULL。
- pg_repack 无法对临时表进行清理。
- pg_repack 运行时无法对 repack 操作中的表执行 DDL。pg_repack 会持有 ACCESS SHARE 锁，禁止 DDL 执行。
- 重建表和索引时会占用较多的磁盘 IO，建议在使用时提前评估对业务的影响。
- pg_repack 期间不要执行大量的 DML 操作，尤其是 UPDATE，否则会影响 repack 的效率和效果。
- pg_repack 期间会产生大量的 WAL 日志，会对归档产生一定的影响。
- 必须在需要进行 repack 的目标数据库创建插件。
- pg_repack 必须以高权限用户执行。
- 在对大表执行 repack 之前，建议对参与 repack 的高权限账号执行 ALTER USER 高权限账号名 SET idle_in_transaction_session_timeout to 0，防止因为 repack 时间超长导致 repack 任务失败。在 repack 任务执行完成后，通过 ALTER USER 高权限账号名 RESET idle_in_transaction_session_timeout 重置即可。
- 在待执行 repack 的目标库上，不能存在 FOR ALL TABLES 的 publication，否则会导致 repack 在最后应用增量阶段失败。在执行 repack 前，可以通过 SELECT count(*) FROM pg_publication WHERE puballtables = true 查询待 repack 的目标库上是否存在 FOR ALL TABLES 的 publication，查询结果为 0 则表示不存在。
创建与删除插件
注意
pg_repack 插件无法通过 UPDATE 的方式升级，必须先删除旧版本插件再创建新版本插件。
- 创建插件
说明
需使用高权限账号创建插件。
-
- 删除插件
-
安装客户端
pg_repack 需配合客户端使用，编译方式如下：
- 下载 PostgreSQL 12.13，并解压、编译和安装。
- 配置环境变量。
- 下载 pg_repack 1.4.8 版本源码并编译和安装。
说明
pg_repack 1.5.2 版本安装过程基本一致，只需在以下步骤中修改版本号为 1.5.2 即可。
说明
如您的环境为 Linxu x86，可通过以下链接获取包含了 pg_repack 的客户端。
- pg_repack 1.4.8
- pg_repack 1.5.2
- pg_repack 1.5.3
使用示例
- 查看帮助手册：pg_repack --help。
-
- 查看当前 pg_repack 版本。
-
- 仅打印支持 repack 的表，但不实际执行：--dry-run 。
-
- repack 单表。
-
- repack 索引。
- repack 目标表的所有索引
-
- repack 目标表的指定索引
-
- repack 所有库。
- 出于对 repack 成功率和效率的考虑，建议您优先选择单表 repack，不进行全库 repack。
-
更多参考
最近更新时间：2026.10.16 14:15:13
这个页面对您有帮助吗？
有用
有用
无用
无用