wangyi2005/postgis

postgis 镜像文档

镜像概述

postgis镜像是一个集成了PostGIS空间扩展的PostgreSQL数据库Docker镜像。PostGIS为PostgreSQL提供空间数据类型、空间索引和地理信息处理功能，使数据库能够存储和操作地理空间数据，适用于地理信息系统（GIS）应用和空间数据分析场景。

核心功能与特性

• 基于PostgreSQL数据库，提供完整关系型数据库功能
• 集成PostGIS扩展，支持点、线、面等空间数据类型
• 提供空间索引能力，优化空间查询性能
• 支持地理信息处理函数（距离计算、面积测量、空间叠加等）
• 可通过环境变量配置数据库用户、密码和初始数据库

环境变量配置

使用场景

• 地理信息系统（GIS）应用后端数据库
• 空间数据分析与处理平台
• 位置服务应用（地图服务、位置查询等）
• 需要存储和查询空间数据的企业应用

使用方法

基本运行命令

使用docker run启动容器，需指定环境变量并挂载数据卷以持久化数据：

bash
docker run -d \
  --name postgis \
  -e POSTGRESQL_USER=myuser \
  -e POSTGRESQL_PASSWORD=mypassword \
  -e POSTGRESQL_DATABASE=mydb \
  -e POSTGRESQL_ADMIN_PASSWORD=adminpass \
  -v postgis-data:/postgis/data \
  -p 5432:5432 \
  postgis

数据持久化

PostgreSQL数据存储在/postgis/data目录，建议通过Docker卷挂载持久化数据：

bash
# 创建命名卷
docker volume create postgis-data

# 挂载卷运行容器
docker run -d ... -v postgis-data:/postgis/data postgis

OpenShift配置示例

在OpenShift环境中配置持久卷：

bash
oc volume dc/postgis --add --claim-size 1Gi --mount-path /postgis/data --name postgis-data

连接数据库

使用PostgreSQL客户端连接：

bash
psql -h localhost -p 5432 -U myuser -d mydb

验证PostGIS扩展：

sql
SELECT postgis_version();

返回版本信息表示PostGIS已成功加载。