gregli/postgres

abfm 镜像文档

镜像概述

abfm 是一个基于 PostgreSQL 的扩展镜像，预集成了多个实用扩展组件，旨在为特定业务场景提供开箱即用的数据库功能支持。该镜像的 tag 为 abfm，包含以下核心组件：plv8 v2.1.0、postgis v2.4.4、zhparser 和 osml10n。

核心功能与特性

1. plv8 v2.1.0

• 功能：PostgreSQL 的 JavaScript 引擎扩展，允许在数据库中直接运行 JavaScript 代码。
• 价值：支持复杂业务逻辑的 JavaScript 存储过程、触发器及函数，扩展数据库处理能力。

2. postgis v2.4.4

• 功能：PostgreSQL 的空间数据库扩展，提供地理空间数据存储、查询和分析能力。
• 价值：支持点、线、面等空间数据类型，以及距离计算、空间索引、地图投影等空间操作。

3. zhparser

• 功能：中文分词扩展，基于 PostgreSQL 全文搜索框架，支持中文文本的分词处理。
• 价值：实现中文全文检索，提升中文内容的搜索准确性和效率。

4. osml10n

• 功能：OpenStreetMap (OSM) 数据本地化扩展，提供 OSM 数据的多语言本地化处理能力。
• 价值：支持 OSM 地理数据的本地化标签处理、多语言名称解析等。

使用场景与适用范围

• 地理信息系统（GIS）应用：需处理空间数据（如地图、位置服务）的场景，依赖 postgis 进行空间数据管理。
• 中文内容平台：需实现中文全文检索的应用，通过 zhparser 提升搜索体验。
• 复杂业务逻辑处理：需在数据库层嵌入 JavaScript 逻辑的场景，利用 plv8 扩展实现灵活的业务规则。
• OSM 数据处理：需对 OpenStreetMap 数据进行本地化处理（如多语言标签管理）的应用，依赖 osml10n 扩展。

使用方法与配置说明

基本部署（docker run）

bash
docker run -d \
  --name abfm-postgres \
  -e POSTGRES_PASSWORD=your_password \
  -e POSTGRES_USER=your_user \
  -e POSTGRES_DB=your_db \
  -p 5432:5432 \
  [镜像名称]:abfm

环境变量说明

扩展启用方法

容器启动后，可通过 psql 连接数据库并启用扩展：

sql
-- 启用 plv8
CREATE EXTENSION plv8;

-- 启用 postgis
CREATE EXTENSION postgis;
CREATE EXTENSION postgis_topology;  -- 可选，拓扑功能

-- 启用 zhparser
CREATE EXTENSION zhparser;
-- 创建中文全文搜索配置（示例）
CREATE TEXT SEARCH CONFIGURATION chinese_zh (PARSER = zhparser);
ALTER TEXT SEARCH CONFIGURATION chinese_zh ADD MAPPING FOR n,v,a,i,e,l WITH simple;

-- 启用 osml10n
CREATE EXTENSION osml10n;

docker-compose 配置示例

yaml
version: '3'
services:
  abfm-postgres:
    image: [镜像名称]:abfm
    container_name: abfm-postgres
    environment:
      POSTGRES_PASSWORD: your_password
      POSTGRES_USER: your_user
      POSTGRES_DB: your_db
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

注意事项

• 扩展版本固定：镜像中 plv8、postgis 等扩展版本已预编译，不支持动态升级，如需更新版本需使用对应 tag 的镜像。
• 资源需求：postgis 和 osml10n 可能增加数据库资源消耗，建议根据数据量和查询复杂度配置适当的 CPU/内存资源。
• 数据持久化：通过挂载 volumes 确保数据持久化，避免容器删除导致数据丢失。