pacificporter/postgres-bigm

postgres-bigm-docker

镜像概述

postgres-bigm-docker是基于官方PostgreSQL镜像构建的Docker镜像，预安装并配置了BigM扩展。BigM扩展为PostgreSQL提供任意精度大整数和大数值运算支持，特别适用于处理超出标准整数类型范围数值的应用场景。

核心功能和特性

• 预安装BigM扩展：无需手动编译安装，开箱即可使用
• 自动加载配置：通过配置自动加载BigM扩展，无需手动启用
• 多版本支持：兼容PostgreSQL 14及以上版本
• 官方镜像兼容：基于官方PostgreSQL镜像构建，保留所有官方功能
• 简化部署：简化在容器环境中部署PostgreSQL+BigM的流程

使用场景和适用范围

• ***应用中处理大整数或高精度数值
• 科学计算和数据分析场景
• 需要存储超出64位整数范围数值的应用
• 开发和测试环境中快速部署BigM支持的PostgreSQL
• 容器化环境中部署具备BigM扩展的数据库服务

使用方法和配置说明

基本使用

使用docker run命令启动容器：

bash
docker run -d \
  --name postgres-bigm \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -p 5432:5432 \
  pacificporter/postgres-bigm:14

使用docker-compose

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  postgres:
    image: pacificporter/postgres-bigm:14
    container_name: postgres-bigm
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_USER: postgres
      POSTGRES_DB: mydb
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-data:

启动服务：

bash
docker-compose up -d

验证BigM扩展

连接数据库验证扩展是否加载：

bash
docker exec -it postgres-bigm psql -U postgres

# 在PostgreSQL终端执行
SELECT * FROM pg_extension WHERE extname = 'bigm';

返回结果包含bigm扩展即表示安装成功。

使用BigM数据类型

BigM扩展提供bigm数据类型用于存储和操作大整数：

sql
-- 创建表
CREATE TABLE large_numbers (
    id SERIAL PRIMARY KEY,
    value bigm
);

-- 插入大整数
INSERT INTO large_numbers (value) VALUES (1234567890123456789012345678901234567890);

-- 查询数据
SELECT * FROM large_numbers;

环境变量

支持所有官方PostgreSQL镜像环境变量，主要包括：

• POSTGRES_PASSWORD: 数据库超级用户密码（必填）
• POSTGRES_USER: 数据库超级用户名（默认：postgres）
• POSTGRES_DB: 初始数据库名称（默认：与POSTGRES_USER相同）
• PGDATA: 数据库文件存储路径（默认：/var/lib/postgresql/data）

数据持久化

使用Docker卷或绑定挂载持久化数据：

bash
docker run -d \
  --name postgres-bigm \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  pacificporter/postgres-bigm:14

版本标签

镜像标签遵循postgres版本格式：

• pacificporter/postgres-bigm:14 - PostgreSQL 14.x版本
• pacificporter/postgres-bigm:15 - PostgreSQL 15.x版本

建议使用特定主版本标签确保稳定性。

构建自定义镜像

可基于此镜像构建自定义Dockerfile：

dockerfile
FROM pacificporter/postgres-bigm:14
COPY custom-postgresql.conf /etc/postgresql/postgresql.conf.d/

构建并使用：

bash
docker build -t my-postgres-bigm .
docker run -d --name my-postgres -e POSTGRES_PASSWORD=pass my-postgres-bigm

验证安装

连接数据库验证BigM扩展状态：

bash
docker exec -it postgres-bigm psql -U postgres -c "SELECT * FROM pg_extension WHERE extname = 'bigm';"

若返回结果包含bigm扩展信息，则表示安装成功。