orangedm/postgres

PostgreSQL（启用quantile和tsm_system_time扩展）镜像文档

镜像概述

本镜像基于官方PostgreSQL构建，预启用了quantile（分位数计算）和tsm_system_time（时间序列数据管理）扩展，旨在为需要高级统计分析和时间序列数据处理的应用提供开箱即用的数据库环境。通过集成这两个扩展，可直接支持分位数统计计算及时间序列数据的高效存储与查询，无需手动配置扩展。

核心功能和特性

• 分位数计算支持：通过quantile扩展提供分位数（如中位数、四分位数等）统计功能，适用于数据分析、监控指标计算等场景。
• 时间序列优化：tsm_system_time扩展针对时间序列数据（如传感器数据、日志记录）提供存储优化和查询性能提升，减少存储空间占用并加速时间范围查询。
• 兼容性保障：基于官方PostgreSQL镜像构建，确保与PostgreSQL生态工具链（如pgAdmin、psql）完全兼容。
• 即开即用：扩展预启用，无需手动执行CREATE EXTENSION命令，容器启动后可直接使用扩展功能。

使用场景和适用范围

• 统计分析场景：需频繁计算分位数（如用户行为指标、业务数据分布分析）的应用。
• 时间序列数据管理：物联网（IoT）传感器数据、服务器监控日志、***时间序列数据等场景。
• 混合负载场景：同时需要标准SQL功能和高级统计/时间序列处理能力的业务系统。

使用方法和配置说明

基本使用（docker run）

bash
docker run -d \
  --name postgres-quantile-tsm \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  -p 5432:5432 \
  [镜像名称]:[标签]

Docker Compose配置

yaml
version: '3.8'
services:
  postgres:
    image: [镜像名称]:[标签]
    container_name: postgres-quantile-tsm
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: mydb
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

环境变量配置

验证扩展是否启用

容器启动后，通过psql连接数据库并执行以下命令验证扩展：

sql
-- 检查quantile扩展
SELECT * FROM pg_extension WHERE extname = 'quantile';

-- 检查tsm_system_time扩展
SELECT * FROM pg_extension WHERE extname = 'tsm_system_time';

扩展功能示例

分位数计算（quantile）

sql
-- 创建测试表
CREATE TABLE test_data (value numeric);
INSERT INTO test_data VALUES (1), (2), (3), (4), (5), (6), (7), (8), (9), (10);

-- 计算中位数（0.5分位数）
SELECT quantile(value, 0.5) FROM test_data; -- 结果：5.5

时间序列数据管理（tsm_systemsystem_time

sql
-- 创建带时间
CREATE 时间序列表（使用tsm_system_time表空间）
CREATE TABLE sensor_data (
  time timestamp NOT NULL,
  sensor_id int NOT NULL,
  value numeric NOT NULL
) WITH (timescaledb.transaction_per_chunk = true);

-- 将表转换为时间序列表（按时间分区）
SELECT create_hypertable('sensor_data', 'time');

-- 插入时间序列数据
INSERT INTO sensor_data (time, sensor_id, value)
VALUES 
  (NOW()  INTERVAL '1 minute', 1, 23.5),
  (NOW() - INTERVAL '2 minutes', 1, 24.1),
  (NOW() - INTERVAL '3 minutes', 1, 22.8);

-- 查询最近5分钟数据
SELECT * FROM sensor_data WHERE time > NOW() - INTERVAL '5 minutes';

注意事项

• 镜像基于特定PostgreSQL版本构建，使用前需确认与应用兼容的PostgreSQL版本。
• 生产环境建议通过volumes挂载数据目录，避免容器删除导致数据丢失。
• tsm_system_time扩展依赖TimescaleDB，确保镜像已包含相关依赖（部分实现可能基于TimescaleDB社区版）。