urbanstore/postgres

PostgreSQL 镜像（含postgresql-contrib）

镜像概述

本Docker镜像基于PostgreSQL构建，已预先安装postgresql-contrib扩展包。PostgreSQL是一款功能强大的开源对象关系型数据库系统，以其可靠性、数据完整性和扩展性著称。postgresql-contrib包含一系列官方维护的附加功能模块，扩展了数据库的核心能力。

核心功能与特性

PostgreSQL核心特性

• 完全遵循ACID事务特性，确保数据一致性
• 强大的SQL标准支持，包括复杂查询、子查询、事务和外键约束
• 支持多种数据类型，包括JSON、数组、地理信息等
• 高可靠性和数据完整性保障机制

postgresql-contrib扩展功能

• 提供额外的数据类型（如hstore键值对存储、citext大小写不敏感文本）
• 实用工具（如pg_trgm文本相似性搜索、pgcrypto数据加密）
• 管理工具（如pg_stat_statements性能监控、pg_buffercache缓存分析）

使用场景

• 需要额外扩展功能的企业级数据库应用
• 开发环境中快速部署包含完整扩展的PostgreSQL实例
• 数据处理场景中需使用特殊数据类型或功能的应用（如全文搜索、数据加密）
• 对数据库性能监控和分析有需求的场景

使用方法

基本运行命令

bash
docker run -d \
  --name postgres-with-contrib \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_DB=mydb \
  -v postgres-data:/var/lib/postgresql/data \
  postgres:latest

环境变量说明

数据持久化

通过挂载卷确保数据持久化：

bash
docker volume create postgres-data
docker run -d \
  --name postgres-with-contrib \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v postgres-data:/var/lib/postgresql/data \
  postgres:latest

使用contrib扩展示例

1. 进入容器：

bash
docker exec -it postgres-with-contrib psql -U myuser -d mydb

2. 启用hstore扩展：

sql
CREATE EXTENSION hstore;

3. 创建包含hstore类型的表：

sql
CREATE TABLE products (
  id SERIAL PRIMARY KEY,
  name VARCHAR(100),
  attributes hstore
);

4. 插入数据：

sql
INSERT INTO products (name, attributes) 
VALUES ('Laptop', 'brand=>"Dell", color=>"Silver", storage=>"512GB"');

注意事项

• 生产环境中建议使用持久卷存储数据，避免容器删除导致数据丢失
• 根据实际需求调整资源限制（如--memory、--cpus参数）
• 定期备份数据库数据，可通过pg_dump工具实现
• 如需网络访问，可通过-p 5432:5432映射端口（生产环境建议限制访问来源）