ohregistry/postgres-ci

Postgres 14.8 with pg_hint_plan 镜像文档

镜像概述

本镜像基于PostgreSQL 14.8版本构建，集成了pg_hint_plan扩展，专为CI（持续集成）环境设计。pg_hint_plan扩展允许用户通过SQL注释提供执行计划提示，帮助优化查询性能，适用于在自动化测试流程中验证查询执行计划的正确性和性能表现。

核心功能与特性

• 基础环境：基于官方PostgreSQL 14.8镜像构建，包含完整的PostgreSQL数据库功能
• 扩展集成：预安装pg_hint_plan扩展，支持通过SQL注释控制查询执行计划
• CI优化：轻量级配置，适合集成到自动化测试流程，快速启动和销毁
• 兼容性：与PostgreSQL 14.8原生功能完全兼容，支持标准PostgreSQL客户端连接

使用场景与适用范围

• CI/CD流程中的数据库自动化测试
• 查询性能验证与执行计划稳定性测试
• 需要自定义执行计划的SQL脚本测试
• 开发环境中查询优化调试

使用方法与配置说明

基本部署

Docker Run 命令

bash
docker run -d \
  --name ci-postgres \
  -e POSTGRES_USER=testuser \
  -e POSTGRES_PASSWORD=testpass \
  -e POSTGRES_DB=testdb \
  -p 5432:5432 \
  postgres-14.8-pg-hint-plan:latest

Docker Compose 配置

yaml
version: '3'
services:
  postgres:
    image: postgres-14.8-pg-hint-plan:latest
    container_name: ci-postgres
    environment:
      POSTGRES_USER: testuser
      POSTGRES_PASSWORD: testpass
      POSTGRES_DB: testdb
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

环境变量配置

pg_hint_plan 使用验证

1. 连接数据库：

bash
psql -h localhost -U testuser -d testdb

2. 验证扩展安装：

sql
SELECT * FROM pg_extension WHERE extname = 'pg_hint_plan';

3. 使用示例（强制索引扫描）：

sql
/*+ IndexScan(t1 idx_t1_id) */
SELECT * FROM t1 WHERE id = 1;

注意事项

• 本镜像专为CI环境设计，不建议用于生产环境
• 如需持久化数据，建议挂载数据卷（如示例中的postgres-data）
• pg_hint_plan扩展需在数据库连接后通过LOAD 'pg_hint_plan';手动加载（部分配置下可能自动加载）
• 具体hint语法请参考pg_hint_plan官方文档