kpettijohn/postgis

PostGIS

镜像概述和主要用途

PostGIS是PostgreSQL对象关系型数据库的空间数据库扩展。它添加了对地理对象的支持，允许在SQL中运行位置查询。本镜像基于官方postgres Docker镜像构建，继承了其基本功能并扩展了空间数据处理能力。

核心功能和特性

• 空间数据支持：添加地理对象类型，支持几何(geometry)、地理(geography)和栅格(raster)等空间数据类型
• 空间查询能力：允许在SQL中执行位置查询，如距离计算、空间关系判断等
• 预配置模板：包含template_postgis数据库模板，预装postgis和postgis_topology扩展
• 与PostgreSQL兼容：基于官方PostgreSQL镜像，保持与PostgreSQL生态系统的兼容性

使用场景和适用范围

• 地理信息系统(GIS)应用开发
• 需要空间数据存储和查询的应用
• 位置服务和地图应用
• 空间分析和地理数据处理

使用方法和配置说明

基本使用

启动PostGIS容器

使用以下命令启动一个PostGIS容器：

bash
docker run --name server-name -p "5432:5432" -d docker.xuanyuan.run/postgis

参数说明：

• --name server-name：指定容器名称
• -p "5432:5432"：将容器的5432端口映射到主机的5432端口
• -d：后台运行容器

连接到数据库

容器启动后，可以使用psql直接连接：

bash
psql -h `docker-machine ip` -U postgres -l

也可以使用docker exec在容器内执行命令：

bash
docker exec server-name psql -U postgres -l

执行上述命令后，将显示数据库列表，其中包含预创建的template_postgis模板数据库。

创建空间数据库

template_postgis模板已预装postgis和postgis_topology扩展，可直接用于创建新的空间数据库：

bash
# 创建基于template_postgis的数据库
docker exec server-name psql -U postgres -c "CREATE DATABASE my_db TEMPLATE template_postgis;"

# 查看已安装的扩展
docker exec server-name psql -U postgres -d my_db -c "\dx"

执行结果将显示已安装的扩展，包括postgis和postgis_topology。