cherts/pg-repack

pg_repack Docker镜像（基于Alpine Linux）

镜像概述和主要用途

本Docker镜像基于Alpine Linux构建，已预装pg_repack（PostgreSQL扩展），可作为客户端工具运行/调用pg_repack功能，用于已在服务器端安装该扩展的PostgreSQL数据库。pg_repack是一款用于优化PostgreSQL表空间、减少表碎片的工具，无需停机即可重组表结构。

参考：https://github.com/reorg/pg_repack

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 版本匹配：严格遵循pg_repack官方版本，并与特定PostgreSQL版本保持兼容性
• 客户端模式：无需在数据库服务器直接安装，通过客户端连接即可执行优化操作
• 完整工具链：包含pg_repack全部功能，支持表、索引等数据库对象的重组

版本信息

本镜像版本与pg_repack官方发布及PostgreSQL兼容性对应关系如下：

更多版本信息请参见GitHub：https://github.com/cherts/pg_repack_docker/

使用场景和适用范围

• PostgreSQL数据库表因频繁更新、删除导致的空间碎片优化
• 需在不停机情况下重组表结构以提升查询性能
• 数据库维护中需要回收未使用空间
• 与CI/CD流程集成，定期执行数据库优化任务

使用方法和配置说明

基本使用方式

通过docker run命令直接执行pg_repack，需提供PostgreSQL连接参数：

bash
docker run --rm cherts/pg-repack:<版本标签> pg_repack [选项]

常用连接参数

环境变量配置

为避免在命令行暴露敏感信息，可通过环境变量配置连接参数：

示例

1. 重组指定数据库的所有表

bash
docker run --rm \
  -e PGHOST=postgres-host \
  -e PGUSER=dbadmin \
  -e PGDATABASE=mydb \
  -e PGPASSWORD=secret \
  cherts/pg-repack:1.5.2 pg_repack

2. 重组指定表

bash
docker run --rm cherts/pg-repack:1.5.2 \
  pg_repack -h postgres-host -U dbadmin -d mydb -t orders

3. 重组指定模式下的表

bash
docker run --rm cherts/pg-repack:1.5.2 \
  pg_repack -h postgres-host -U dbadmin -d mydb -s sales -t customers

注意事项

• 确保目标PostgreSQL数据库已安装pg_repack扩展（通过CREATE EXTENSION pg_repack;命令安装）
• 运行用户需具备足够权限（如超级用户或拥有REPACK_TABLE权限）
• 执行过程中会生成临时表，需确保数据库有足够可用空间
• 建议在低峰期执行，避免影响业务性能