PostgreSQL with pg_partman 镜像文档

镜像概述

本镜像基于官方PostgreSQL镜像构建，预集成并配置了pg_partman扩展。pg_partman是一个PostgreSQL扩展，用于简化和自动化表分区的创建、维护与管理流程，特别适用于时间序列数据或需要按范围分区的场景，帮助用户减少手动分区操作，提升数据库性能和可维护性。

核心功能和特性

• 预安装pg_partman扩展：基于官方PostgreSQL镜像，无需手动安装，开箱即可使用pg_partman功能。
• 自动化分区管理：支持自动创建新分区（基于时间或数值范围）和自动清理旧分区，减少人工干预。
• 多分区类型支持：兼容PostgreSQL原生分区功能，支持时间范围分区（如按天、月）和数值范围分区（如按ID范围）。
• 灵活的分区策略：可配置分区间隔（如1小时、1个月）、保留策略（如保留最近3个月数据）、分区命名规则等。
• 性能优化：通过分区减少单表数据量，提升查询效率，尤其适用于大数据量表的查询和维护。
• 与PostgreSQL版本兼容：支持主流PostgreSQL版本（如12+），兼容原生分区语法和功能。

使用场景和适用范围

• 时间序列数据存储：适用于监控指标、日志数据、传感器数据等按时间增长的海量数据场景。
• 高性能查询需求：当数据库表数据量达到百万/千万级以上，需通过分区提升查询速度和索引效率。
• 自动化运维场景：减少DBA手动创建/删除分区的操作成本，尤其适合需要定期维护分区的业务。
• 合规性数据保留：需按法规要求自动保留指定时间段数据（如金融交易记录保留5年）的场景。

使用方法和配置说明

1. 镜像拉取

假设镜像已构建并推送到私有仓库或Docker Hub（实际使用时替换<image-name>为具体镜像名称）：

docker pull <image-name>:<tag>  # 示例：docker pull my-postgres-pgpartman:14

2. 环境变量配置

3. Docker 部署示例

3.1 基础 docker run 命令

docker run -d \
  --name postgres-pgpartman \
  -p 5432:5432 \
  -e POSTGRES_DB=myappdb \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=SecurePass123! \
  -e PGPARTMAN_PARTITION_TYPE=time \
  -e PGPARTMAN_INTERVAL=1d \
  -e PGPARTMAN_RETENTION=90 \
  -v postgres-data:/var/lib/postgresql/data \
  <image-name>:<tag>

3.2 Docker Compose 配置示例

version: '3.8'
services:
  postgres:
    image: <image-name>:<tag>
    container_name: postgres-pgpartman
    ports:
      - "5432:5432"
    environment:
      POSTGRES_DB: "metrics_db"
      POSTGRES_USER: "metrics_user"
      POSTGRES_PASSWORD: "MetricsPass456!"
      PGPARTMAN_PARTITION_TYPE: "time"
      PGPARTMAN_INTERVAL: "1h"  # 按小时分区
      PGPARTMAN_RETENTION: "720"  # 保留30天（720小时）数据
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-data:

4. 初始化分区表

容器启动后，需手动或通过初始化脚本创建分区表（以下为示例SQL，通过psql执行）：

-- 1. 切换到目标数据库
\c metrics_db

-- 2. 创建主表（需与pg_partman分区策略匹配）
CREATE TABLE metrics (
  time timestamp NOT NULL,
  metric_name text NOT NULL,
  value numeric NOT NULL
);

-- 3. 使用pg_partman创建分区（假设按time字段小时分区）
SELECT partman.create_parent(
  p_parent_table := 'public.metrics',
  p_control := 'time',  -- 分区控制字段
  p_type := 'time',     -- 分区类型（与环境变量一致）
  p_interval := '1 hour',  -- 分区间隔（与环境变量一致）
  p_retention := '720 hours'  -- 保留策略（与环境变量一致）
);

5. 验证分区配置

-- 查看分区表结构
SELECT * FROM partman.show_partitions('public.metrics');

-- 查看pg_partman配置
SELECT * FROM partman.partition_config WHERE parent_table = 'public.metrics';

注意事项

• 数据备份：分区表数据仍需通过PostgreSQL标准工具（如pg_dump）定期备份，避免数据丢失。
• 版本兼容性：确保pg_partman版本与PostgreSQL版本匹配（参考pg_partman官方文档）。
• 性能监控：分区操作（如自动创建/删除）可能影响数据库性能，建议在低峰期执行或调整pg_cron调度（如需定时任务）。
• 权限管理：确保应用用户具有分区表的读写权限，以及对partman schema的访问权限。