a1091/postgres-with-bigm

PostgreSQL with pg-bigm 扩展 Docker 镜像

镜像概述

本Docker镜像基于PostgreSQL数据库，集成了pg-bigm扩展，专为需要高效处理中文全文搜索的场景设计。pg-bigm是一个针对中文等东亚语言优化的全文搜索扩展，通过改进分词算法提升中文文本检索的准确性和效率。该镜像提供开箱即用的PostgreSQL+pg-bigm环境，简化中文搜索功能的部署流程。

核心功能与特性

• 基础PostgreSQL功能：完整支持PostgreSQL数据库的所有标准功能，包括ACID事务、复杂查询、JSON支持等
• pg-bigm扩展集成：预安装并启用pg-bigm扩展，支持中文分词和全文搜索优化
• 便捷部署：Docker化封装，无需手动编译安装pg-bigm扩展，减少环境配置复杂度
• 环境一致性：确保不同环境下PostgreSQL与pg-bigm版本的一致性，避免依赖冲突
• 数据持久化：支持通过Docker卷挂载实现数据持久化，保障数据安全

使用场景与适用范围

• 中文内容管理系统：需要对中文文章、新闻进行全文检索的CMS平台
• 文档检索系统：企业内部文档、知识库的中文全文搜索功能
• 中文电商平台：商品标题、描述的中文关键词搜索
• 开发测试环境：快速搭建包含中文搜索功能的PostgreSQL开发环境
• 中小型应用：需要轻量级中文搜索解决方案，无需复杂Elasticsearch等引擎的场景

使用方法与配置说明

基本使用（docker run）

bash
docker run -d \
  --name postgres-bigm \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  postgres-bigm:latest

docker-compose配置示例

yaml
version: '3'
services:
  postgres:
    image: postgres-bigm:latest
    container_name: postgres-bigm
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: mydb
      PGDATA: /var/lib/postgresql/data/pgdata
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-data:

环境变量配置

验证pg-bigm扩展

容器启动后，可通过以下步骤验证pg-bigm是否成功安装：

1. 进入容器：

bash
docker exec -it postgres-bigm psql -U myuser -d mydb

2. 查询已安装扩展：

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

若返回包含pg_bigm的记录，则扩展安装成功。

使用pg-bigm进行中文搜索

创建测试表并使用pg-bigm功能：

sql
-- 创建测试表
CREATE TABLE articles (
  id SERIAL PRIMARY KEY,
  content TEXT
);

-- 插入测试数据
INSERT INTO articles (content) VALUES 
  ('这是一篇关于Docker的文章'),
  ('PostgreSQL是一个强大的数据库'),
  ('pg-bigm扩展提升中文搜索效率');

-- 创建GIN索引（使用pg-bigm的分词功能）
CREATE INDEX idx_articles_content ON articles USING gin (content gin_bigm_ops);

-- 执行中文搜索
SELECT * FROM articles WHERE content @@ to_tsquery('pg_bigm', '中文 搜索');

数据持久化

通过挂载Docker卷（如示例中的postgres-data卷）可实现数据持久化，即使容器删除或重建，数据也不会丢失。建议在生产环境中始终使用卷挂载。

版本说明

该镜像基于官方PostgreSQL镜像构建，pg-bigm扩展版本会随PostgreSQL版本同步更新，具体版本信息可参考镜像标签或官方文档。