RDS PostgreSQL支持通过插件pg_repack在线清理表空间，有效解决因对全表大量更新等操作引起的表膨胀问题。pg_repack无需获取排它锁，相比CLUSTER或VACUUM FULL更加轻量化。
您可以加入RDS PostgreSQL插件交流钉钉群（103525002795），进行咨询、交流和反馈，获取更多关于插件的信息。
前提条件
实例大版本为RDS PostgreSQL 10或以上。
说明暂不支持RDS PostgreSQL 17。
实例小版本为20240229及以上。如需升级内核小版本，请参见升级内核小版本。
说明当实例的小版本低于20240229时，使用该插件可能会导致出现报错：
ERROR: must be superuser to use xxx function。
注意事项
pg_repack需要额外的存储空间。全表repack时，剩余存储空间大小需要至少是待repack表大小的2倍。
pg_repack无法操作临时表。
pg_repack无法操作GiST索引。
pg_repack运行时无法对repack操作中的表执行DDL。pg_repack会持有ACCESS SHARE锁，禁止DDL执行。
重建表和索引时会占用较多的磁盘IO，使用时请提前评估是否影响业务。以ESSD PL1云盘为例，repack 100GB的表时，会达到IO吞吐上限（250MB/s）。
功能介绍
pg_repack插件支持全表repack和索引repack。
对整表数据进行repack的实现原理如下：
创建日志表记录对原表的变更。
在原表创建触发器，将原表的INSERT、UPDATE和DELETE操作记录到日志表中。
创建新表，与原表的行列相同。
在新表中创建索引。
将日志表里的变更应用到新表。
在system catalog交换新旧表。
删除旧表。
说明pg_repack会在第a、b步和第f、g步短暂持有ACCESS EXCLUSIVE锁。其余步骤pg_repack只需要持有原表的ACCESS SHARE锁，不影响原表的INSERT、UPDATE和DELETE。
对表中索引进行repack的实现原理如下：
以CONCURRENTLY方式创建新索引。
在system catalog交换新旧索引。
删除旧索引。
插件开启与关闭
请使用高权限账号执行如下命令。
开启插件。
CREATE EXTENSION pg_repack;关闭插件。
DROP EXTENSION pg_repack;
安装客户端
pg_repack插件需要配合客户端使用，以ECS Alibaba Cloud Linux 3.2104及以上版本为例，参考以下命令：
安装环境依赖。
sudo yum install postgresql* redhat-rpm-config libpq* openssl-devel readline-devel -y添加环境变量。
export PATH=$PATH:/usr/lib64/pgsql/postgresql-12/bin说明命令中的路径及PostgreSQL版本仅为示例，请根据实际情况进行替换。
下载pg_repack客户端并编译安装。
wget https://github.com/reorg/pg_repack/archive/refs/tags/ver_1.4.6.tar.gz tar zxvf ver_1.4.6.tar.gz cd pg_repack-ver_1.4.6 make && make install
使用示例
-- 检查但不执行：--dry-run
pg_repack --dry-run --no-superuser-check --echo --no-order -h 连接串 -p 端口 -d database1 -U user --table schema1.table1
-- 检查并执行
pg_repack --no-superuser-check --echo --no-order -h 连接串 -p 端口 -d database1 -U user --table schema1.table1常见问题
Q：报错“ERROR: pg_repack failed with error: You must be a superuser to use pg_repack”。
A：请使用-k或--no-superuser-check，避免没有权限。
全表repack时，无法通过此方式拥有权限。
相关参考
pg_repack的详细说明可参考pg_repack官方帮助文档。