symbolspace/zhparser

zhparser 镜像文档

镜像概述

zhparser镜像是一个基于PostGIS的PostgreSQL数据库镜像，集成了zhparser扩展，专门用于实现中文全文搜索功能。该镜像基于symbolspace/postgis（PostgreSQL 12版本）构建，提供了中文分词和全文检索能力，适用于需要对中文内容进行高效搜索的应用场景。

核心功能与特性

• 中文分词支持：通过zhparser扩展实现中文文本的精准分词
• 全文搜索配置：可自定义文本搜索配置，支持多种令牌类型映射
• 基于PostGIS：继承PostGIS的空间数据处理能力，适用于同时需要空间数据和中文搜索的场景
• PostgreSQL 12基础：基于稳定的PostgreSQL 12版本，确保兼容性和可靠性

使用场景

• 中文内容管理系统的全文检索功能
• 中文文档数据库的关键词搜索
• 需要同时处理空间数据和中文文本搜索的应用
• 博客、论坛等UGC内容平台的中文搜索功能

使用方法

1. 创建扩展

在PostgreSQL中执行以下SQL命令创建并配置zhparser扩展：

sql
-- 创建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;

2. 配置说明

• 配置名称：示例中的chinese_zh为自定义名称，可根据实际需求修改
• 令牌类型：n,v,a,i,e,l等为zhparser支持的令牌类型，未映射的令牌类型将不会用于文档分词
• 查看所有令牌类型：通过\dFp+ zhparser命令可列出zhparser支持的所有令牌类型

3. Docker部署示例

Docker Run命令

bash
docker run -d \
  --name postgres-zhparser \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=your_password \
  -e POSTGRES_DB=your_db \
  docker.xuanyuan.run/symbolspace/postgis-zhparser:latest

Docker Compose配置

yaml
version: '3'
services:
  postgres-zhparser:
    image: docker.xuanyuan.run/symbolspace/postgis-zhparser:latest
    container_name: postgres-zhparser
    ports:
      - "5432:5432"
    environment:
      - POSTGRES_PASSWORD=your_password
      - POSTGRES_USER=your_user
      - POSTGRES_DB=your_db
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

来源

该镜像基于https://github.com/chen-xin/docker_zhparser项目构建。