从零开始学PostgreSQL-工具篇2:碎片回收pg_repack

yum install lz4-devel

[root@test19-server07 opt]# wget https://github.com/reorg/pg_repack/archive/refs/tags/ver_1.5.1.tar.gz
shell > tar xvf ver_1.5.1.tar.gz
shell > mv pg_repack-ver_1.5.1/  pg_repack
shell > cd pg_repack
shell > export PG_CONFIG=/usr/pgsql-16/bin/pg_config
shell > make
shell > make install 

##安装扩展
[root@test19-server07 ~]# psql -U postgres -h 127.0.0.1 -p 5432 -W
Password: 
psql (16.4)
postgres=# CREATE EXTENSION pg_repack;
CREATE EXTENSION

通用选项
-a, --all: 重组所有数据库。
-t, --table=TABLE: 仅重组特定表。
-I, --parent-table=TABLE: 重组特定父表及其继承者。
-c, --schema=SCHEMA: 仅重组特定模式中的表。
-s, --tablespace=TBLSPC: 将重组后的表移动到新的表空间。
-S, --moveidx: 将重组后的索引也移动到新的表空间。
-o, --order-by=COLUMNS: 按指定列排序而不是按聚簇键排序。
-n, --no-order: 执行 VACUUM FULL 而不是 CLUSTER。
-N, --dry-run: 显示将要重组的内容，但不执行实际操作。
-j, --jobs=NUM: 为每个表使用指定数量的并行任务。
-i, --index=INDEX仅移动指定的索引。
-x, --only-indexes: 仅移动指定表的索引。
-T, --wait-timeout=SECS: 在冲突时取消其他后端的超时时间。
-D, --no-kill-backend: 超时时不杀死其他后端。
-Z, --no-analyze: 结束时不执行 ANALYZE。
-k, --no-superuser-check: 在客户端跳过超级用户检查。
-C, --exclude-extension: 不重组属于特定扩展的表。
--error-on-invalid-index: 当发现无效索引时不进行重组。
--apply-count: 在回放期间每次事务应用的元组数。
--switch-threshold: 当剩余的元组数达到该阈值时切换表。
连接选项
-d, --dbname=DBNAME: 要连接的数据库名称。
-h, --host=HOSTNAME: 数据库服务器主机或套接字目录。
-p, --port=PORT: 数据库服务器端口。
-U, --username=USERNAME: 连接用户名称。
-w, --no-password: 从不提示输入密码。
-W, --password: 强制提示输入密码。
通用选项
-e, --echo: 回显查询。
-E, --elevel=LEVEL: 设置输出消息级别。
--help: 显示帮助信息，然后退出。
--version: 显示版本信息，然后退出。

通过--table参数指定表名，默认情况下效果等同于CLUSTER，repack过程中对之前执行过CLUSTER操作的列进行排序：
/opt/pg_repack/bin/pg_repack -U postgres -h 127.0.0.1 -p 5432 -W -d postgres --no-superuser-check --echo --table public.saas3

如果希望对指定的列进行排序，可以使用--order-by参数来指定列名：
pg_repack -U postgres -h 127.0.0.1 -p 5432 -W -d postgres --order-by name --no-superuser-check --echo --table public.saas3
postgres=# select * from saas3;
 id |   name    |   qq   
----+-----------+--------
  2 | New Test2 | 
  4 | New Test4 | 
  1 | Test1     | 
  3 | Test3     | 
  5 | Test3     | qq1223
(5 rows)
pg_repack -U postgres -h 127.0.0.1 -p 5432 -W -d postgres --order-by id --no-superuser-check --echo --table public.saas3
postgres=# select * from saas3;
 id |   name    |   qq   
----+-----------+--------
  1 | Test1     | 
  2 | New Test2 | 
  3 | Test3     | 
  4 | New Test4 | 
  5 | Test3     | qq1223
(5 rows)

如果不希望进行排序，即希望pg_repack的效果等同于VACUUM FULL，可以使用--no-order参数：
pg_repack -U postgres -h 127.0.0.1 -p 5432 -W -d postgres --no-order --no-superuser-check --echo --table public.saas3

如果数据库集群的CPU和I/O资源充裕，可以使用--jobs参数加速repack操作，它会启动多个进程并发重建索引，适用于表上有多个索引的场景：
pg_repack -U postgres -h 127.0.0.1 -p 5432 -W -d postgres --no-order --no-superuser-check --echo --jobs 3 --table public.saas3

锁冲突时等待最多 30 秒。如果在这 30 秒内锁仍未释放，pg_repack 不会终止其他后端进程，而是放弃重组操作并返回错误
pg_repack -U postgres -h 127.0.0.1 -p 5432 -W -d postgres --no-superuser-check --echo --table public.saas3 --wait-timeout 30 --no-kill-backend

结束时不执行 ANALYZE 操作
pg_repack -U postgres -h 127.0.0.1 -p 5432 -W -d postgres --no-order --no-superuser-check --echo --jobs 3 --parent-table public.saas3 --no-analyze

重组所有数据库
pg_repack -U postgres -h 127.0.0.1 -p 5432 -W -d postgres --no-order --no-superuser-check --echo --jobs 3 --all

pg_repack -U postgres -h 127.0.0.1 -p 5432 -W -d postgres --no-order --no-superuser-check --echo --jobs 3 --parent-table public.saas1

pg_repack -U postgres -h 127.0.0.1 -p 5432 -W -d postgres  --no-superuser-check --echo --index  public.saas3_pkey

pg_repack -U postgres -h 127.0.0.1 -p 5432 -W -d postgres  --no-superuser-check --echo --only-indexes --table public.saas3

pg_repack -U postgres -h 127.0.0.1 -p 5432 -W -d postgres --no-order --no-superuser-check --echo --jobs 3 --parent-table public.saas3 --dry-run