vtamara/postgis-es_co

PostGIS es_CO.UTF-8 镜像文档

镜像概述

本镜像基于官方PostGIS镜像构建，主要用途是扩展其功能以支持es_CO.UTF-8语言环境。通过预配置哥伦比亚西班牙语本地化设置，解决PostgreSQL/PostGIS在处理哥伦比亚地区数据时的字符编码、排序规则及本地化显示问题，同时保留PostGIS的全部空间数据处理能力。

核心功能与特性

• 基于官方镜像：构建于官方PostGIS镜像之上，确保与官方版本完全兼容
• 语言环境支持：预配置es_CO.UTF-8语言环境，支持哥伦比亚西班牙语字符编码
• 本地化兼容：正确处理西班牙语特殊字符（如ñ、á、é、í、ó、ú等）及排序规则
• 完整空间功能：保留PostGIS的全部空间数据存储、查询和分析能力

使用场景与适用范围

• 处理哥伦比亚地区地理空间数据的GIS应用
• 需要存储和显示哥伦比亚西班牙语文本的数据库系统
• 要求正确排序西班牙语特殊字符的PostgreSQL应用
• 基于PostGIS的地理信息系统项目，特别是涉及哥伦比亚区域数据的场景

使用方法与配置说明

前提条件

• 已安装Docker引擎
• 具备基本Docker命令操作能力

镜像获取

假设镜像已构建并命名为postgis-esco（实际使用时请替换为实际镜像名称或路径）：

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/postgis-esco

运行容器

使用以下命令启动带有es_CO.UTF-8语言环境的PostGIS容器：

bash
docker run -d \
  --name postgis-esco-instance \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e POSTGRES_USER=your_user \
  -e POSTGRES_DB=your_database \
  -p 5432:5432 \
  docker.xuanyuan.run/[镜像仓库地址]/postgis-esco

验证语言环境

容器启动后，可通过以下方式验证语言环境配置：

1. 进入容器：

   bash
   docker exec -it postgis-esco-instance bash
   

2. 检查系统语言环境：

   bash
   locale
   

   预期输出应包含：

   LANG=es_CO.UTF-8
   LC_ALL=es_CO.UTF-8
   

3. 连接PostgreSQL验证数据库编码：

   bash
   psql -U your_user -d your_database
   

   执行SQL查询：

   sql
   SHOW server_encoding;
   SHOW client_encoding;
   SHOW lc_collate;
   SHOW lc_ctype;
   

   预期结果：

   • server_encoding: UTF8
   • client_encoding: UTF8
   • lc_collate: es_CO.UTF-8
   • lc_ctype: es_CO.UTF-8

注意事项

• 本镜像仅添加语言环境配置，不修改PostGIS核心功能及版本
• 与官方PostGIS镜像使用方法完全一致，可参考官方文档进行高级配置
• 若需持久化数据，建议通过-v参数挂载数据卷：

  bash
  docker run -d \
    --name postgis-esco-instance \
    -e POSTGRES_PASSWORD=your_secure_password \
    -v /local/path/to/data:/var/lib/postgresql/data \
    -p 5432:5432 \
    [镜像仓库地址]/postgis-esco