PostGIS概述
openGauss提供PostGIS Extension（版本为PostGIS-2.4.2）。PostGIS Extension是PostgreSQL的空间数据库扩展，提供如下空间信息服务功能：空间对象、空间索引、空间操作函数和空间操作符。PostGIS Extension完全遵循OpenGIS规范。
PostGIS Extension依赖第三方开源软件如下：
- Geos 3.6.2
- Proj 4.9.2
- Json 0.12.1
- Libxml2 2.7.1
- Gdal 1.11.0
PostGIS安装
PostGIS Extension源码包可通过网站https://opengauss.obs.cn-south-1.myhuaweicloud.com/dependency/postgis-xc-master-2020-09-17.tar.gz获取。该Extension需使用GCC-7.3（GNU编译器套件）进行编译安装。
- 在整个安装过程中，可使用make -sj和make install -sj命令并行加速编译，-sj命令极低概率性出现安装错误，如果安装失败则请使用make和make install进行串行安装。
- 对于ARM物理机，在configure时增加如下编译参数：--build=aarch64-unknown-linux-gnu。
操作步骤
-
GCC-7.3（GNU编译器套件）编译器安装。若数据库实例中已经安装GCC-7.3编译器，可直接跳过本步骤。
PostGIS安装依赖GCC-7.3编译器。GCC-7.3编译器推荐使用源码由低版本的gcc和g++编译器进行升级安装。若数据库实例中没有低版本gcc和g++编译器，可以通过挂载操作系统镜像等方法进行安装，这里不做赘述。GCC-7.3编译器相关依赖软件包，包括gcc-7.3.0、gmp-6.1.0、mpfr-3.1.4、mpc-1.0.3，安装包下载地址分别为：
https://ftp.gnu.org/gnu/gcc/gcc-7.3.0/gcc-7.3.0.tar.gz
https://ftp.gnu.org/gnu/gmp/gmp-6.1.0.tar.xz
https://ftp.gnu.org/gnu/mpfr/mpfr-3.1.4.tar.gz
https://ftp.gnu.org/gnu/mpc/mpc-1.0.3.tar.gz
为了校验安装包的完整性，请同时下载安装包的同名的.sig文件和keyring文件：
https://ftp.gnu.org/gnu/gcc/gcc-7.3.0/gcc-7.3.0.tar.gz.sig
https://ftp.gnu.org/gnu/gmp/gmp-6.1.0.tar.xz.sig
https://ftp.gnu.org/gnu/mpfr/mpfr-3.1.4.tar.gz.sig
https://ftp.gnu.org/gnu/mpc/mpc-1.0.3.tar.gz.sig
https://ftp.gnu.org/gnu/gnu-keyring.gpg
并使用以下命令验证安装包完整性。
gpg --verify --keyring ./gnu-keyring.gpg your_package_name.sig如果提示信息中出现Good signature from XXX则说明安装包完整。
1). 以操作系统用户omm登录数据库任一主机。
2). 创建GCC安装主目录\$GAUSSHOME/gcc和代码下载目录\$GAUSSHOME/gcc/packages，并下载软件包gcc-7.3.0.tar.gz、gmp-6.1.0.tar.xz、mpc-1.0.3.tar.gz、mpfr-3.1.4.tar.gz至\$GAUSSHOME/gcc/packages目录。
mkdir $GAUSSHOME/gcc mkdir $GAUSSHOME/gcc/packages3). 解压下载软件。
cd $GAUSSHOME/gcc/packages tar -xzf gcc-7.3.0.tar.gz tar -xvJf gmp-6.1.0.tar.xz tar -xzf mpc-1.0.3.tar.gz tar -xzf mpfr-3.1.4.tar.gz4). 创建GCC安装目录。
mkdir $GAUSSHOME/gcc/gcc-7.3.0 mkdir $GAUSSHOME/gcc/gcc-7.3.0/depend mkdir $GAUSSHOME/gcc/gcc-7.3.0/depend/gmp-6.1.0 mkdir $GAUSSHOME/gcc/gcc-7.3.0/depend/mpfr-3.1.4 mkdir $GAUSSHOME/gcc/gcc-7.3.0/depend/mpc-1.0.3 mkdir $GAUSSHOME/gcc/gcc-7.3.0/depend/gcc5). 安装gmp-6.1.0。
进入$GAUSSHOME/gcc/packages/gmp-6.1.0目录，执行下列命令完成gmp安装操作:
cd $GAUSSHOME/gcc/packages/gmp-6.1.0 ./configure --prefix $GAUSSHOME/gcc/gcc-7.3.0/depend/gmp-6.1.0 make -sj make install -sj6). 安装mpfr-3.1.4。
进入$GAUSSHOME/gcc/packages/mpfr-3.1.4目录，执行以下命令完成mpfr安装操作:
cd $GAUSSHOME/gcc/packages/mpfr-3.1.4 ./configure --prefix $GAUSSHOME/gcc/gcc-7.3.0/depend/mpfr-3.1.4 --with-gmp=$GAUSSHOME/gcc/gcc-7.3.0/depend/gmp-6.1.0 make -sj make install -sj7). 安装mpc-1.0.3。
进入$GAUSSHOME/gcc/packages/mpc-1.0.3目录，执行下列命令完成mpc安装操作:
cd $GAUSSHOME/gcc/packages/mpc-1.0.3 ./configure --prefix=$GAUSSHOME/gcc/gcc-7.3.0/depend/mpc-1.0.3 --with-gmp=$GAUSSHOME/gcc/gcc-7.3.0/depend/gmp-6.1.0 --with-mpfr=$GAUSSHOME/gcc/gcc-7.3.0/depend/mpfr-3.1.4 make -sj make install -sj8). 安装gcc-7.3.0。
i) 添加lib路径至~/.bashrc。
在vim编辑器中打开~/.bashrc文档。
vim ~/.bashrc添加以下内容：
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$GAUSSHOME/gcc/gcc-7.3.0/depend/gmp-6.1.0/lib:$GAUSSHOME/gcc/gcc-7.3.0/depend/mpfr-3.1.4/lib:$GAUSSHOME/gcc/gcc-7.3.0/depend/mpc-1.0.3/lib执行如下命令使设置生效。
source ~/.bashrcii)进入$GAUSSHOME/gcc/packages/gcc-7.3.0目录，执行下列命令完成gcc安装操作。
cd $GAUSSHOME/gcc/packages/gcc-7.3.0 ./configure --prefix=$GAUSSHOME/gcc/gcc-7.3.0/depend/gcc -disable-multilib --with-gmp=$GAUSSHOME/gcc/gcc-7.3.0/depend/gmp-6.1.0 -enable-languages=c,c++ --with-mpfr=$GAUSSHOME/gcc/gcc-7.3.0/depend/mpfr-3.1.4 --with-mpc=$GAUSSHOME/gcc/gcc-7.3.0/depend/mpc-1.0.3 make -sj make install -sjiii) 设置环境变量。
在vim编辑器中打开~/.bashrc文档。
vim ~/.bashrc加入以下内容：
export CC=$GAUSSHOME/gcc/gcc-7.3.0/depend/gcc/bin/gcc export CXX=$GAUSSHOME/gcc/gcc-7.3.0/depend/gcc/bin/g++ export LD_LIBRARY_PATH=$GAUSSHOME/gcc/gcc-7.3.0/depend/gcc/lib64:$LD_LIBRARY_PATH export PATH=$GAUSSHOME/gcc/gcc-7.3.0/depend/gcc/bin:$PATH执行如下命令使设置生效。
source ~/.bashrc -
确认zlib已安装。
Libxml2软件包编译安装依赖zlib无损数据压缩库。omm用户可执行find /usr/ -name libz.a（或者执行find $GAUSSHOME/ -name libz.so）查看zlib是否安装(如果libz.a存在则zlib已安装)。
zlib在数据库安装时已默认安装。若查看到zlib未安装，可从网站Download zlib-1.2.8.tar.gz (LIBPNG: PNG reference library)下载并安装。
安装成功后，可以在/usr/local/lib下找到libz.a。
-
autoconf和automake安装。JSON-C软件包编译安装依赖autoconf和automake工具。若数据库实例中没有autoconf和automake工具，可以通过挂载操作系统镜像等方法进行安装，这里不做赘述。
-
PostGIS依赖库安装。
1). 从网站https://opengauss.obs.cn-south-1.myhuaweicloud.com/dependency/postgis-xc-master-2020-09-17.tar.gz获取PostGIS源码至$GAUSSHOME目录，下载压缩包，解压后需将文件夹重命名为postgis-xc。
2). 从网站gpl_dependency/postgis/postgis_2.4.2-2.patch · openGauss/openGauss-third_party - Gitee.com下载补丁文件到$GAUSSHOME目录，并打入补丁。
cd $GAUSSHOME/postgis-xc/ # 由于raster插件相关的文件非Linux格式，所以在patch之前，需要先进行格式转换，若无dos2unix则先安装此工具 dos2unix postgis-2.4.2/postgis_raster--2.4.2.sql patch -p1 < $GAUSSHOME/postgis_2.4.2-2.patch3). 从网站gpl_dependency/postgis/extension_dependency.h · openGauss/openGauss-third_party - Gitee.com下载postgis依赖头文件到$GAUSSHOME/include/postgresql/server/。
4). 分别编译Geos、Proj、JSON-C、Libxml2、PostGIS并生成相关动态链接库。编译命令为：
-
Geos
cd $GAUSSHOME/postgis-xc/geos-3.6.2 chmod +x ./configure ./configure --prefix=$GAUSSHOME/install/geos make -sj make install -sj -
Proj
cd $GAUSSHOME/postgis-xc/proj-4.9.2 chmod +x ./configure ./configure --prefix=$GAUSSHOME/install/proj make -sj make install -sj -
JSON-C
cd $GAUSSHOME/postgis-xc/json-c-json-c-0.12.1-20160607 chmod +x ./configure ./configure --prefix=$GAUSSHOME/install/json make -sj make install -sj -
Libxml2
cd $GAUSSHOME/postgis-xc/libxml2-2.7.1 chmod +x ./configure ./configure --prefix=$GAUSSHOME/install/libxml2 make -sj make install -sj对于ARM操作系统，则需使用如下configure命令：
./configure --prefix=$GAUSSHOME/install/libxml2 --build=aarch64-unknown-linux-gnu -
Gdal
cd $GAUSSHOME/postgis-xc/gdal-1.11.0 chmod +x ./configure chmod +x ./install-sh ./configure --prefix=$GAUSSHOME/install/gdal --with-xml2=$GAUSSHOME/install/libxml2/bin/xml2-config --with-geos=$GAUSSHOME/install/geos/bin/geos-config --with-static_proj4=$GAUSSHOME/install/proj CFLAGS='-O2 -fpermissive -pthread' make -sj make install -sj如果编译出现类似/home/carrot/data/openGauss-server/third_party/buildtools/gcc/res/lib64/libstdc++.la 找不到，可以自建目录，将libstdc++.la拷贝进去，然后再make -sj（如果libstdc++.so出现类似问题，按同样方法处理）。
-
PostGIS
cd $GAUSSHOME/postgis-xc/postgis-2.4.2 chmod +x ./configure # 以下配置包含raster、topology等部分，如不需要可以删除，具体配置可以参考postgis相关文档，若移除则后面的文件拷贝中不需要拷贝相关文件 ./configure --prefix=$GAUSSHOME/install/postgis2.4.2 --with-pgconfig=$GAUSSHOME/bin/pg_config --with-projdir=$GAUSSHOME/install/proj --with-geosconfig=$GAUSSHOME/install/geos/bin/geos-config --with-jsondir=$GAUSSHOME/install/json \ --with-xml2config=$GAUSSHOME/install/libxml2/bin/xml2-config --with-raster --with-gdalconfig=$GAUSSHOME/install/gdal/bin/gdal-config --with-topology --without-address-standardizer \ CFLAGS='-O2 -fpermissive -DPGXC -pthread -D_THREAD_SAFE -D__STDC_FORMAT_MACROS -DMEMORY_CONTEXT_CHECKING -w' CC=g++ make -sj make install -sj如果make -sj报错缺少openGauss头文件，需要从其源码中拷贝到数据库对应的include目录下 详情参考third_party仓库下的postgis安装文档 openGauss-third_party: openGauss third party libraries - Gitee.com 例如缺少： （storage/file/fio_device.h storage/file/fio_device_com.h ddes/dms/ss_aio.h ddes/dms/ss_dms_recovery.h ddes/dms/ss_common_attr.h ddes/dms/ss_init.h storage/dss/dss_api_def.h）等头文件的名称 这些头文件在openGauss-server仓库的src/include目录下，将其复制到\$GAUSSHOME/include/postgresql/server下即可，但要注意目录层级必须与src/include目录保持一致，比如缺少的头文件是storage/file/fio_device.h，那需要创建的文件就是\$GAUSSHOME/include/postgresql/server/storage/file/fio_device.h。 当然，有一个更加直接简单的方法，即执行下面的命令($CODE_BASE为openGauss-server的源代码目录)
mkdir -p $GAUSSHOME/include/postgresql/server/storage/file/ mkdir -p $GAUSSHOME/include/postgresql/server/storage/dss/ mkdir -p $GAUSSHOME/include/postgresql/server/ddes/dms/ cp -r $CODE_BASE/src/include/storage/file/* $GAUSSHOME/include/postgresql/server/storage/file/ cp -r $CODE_BASE/src/include/storage/dss/* $GAUSSHOME/include/postgresql/server/storage/dss/ cp -r $CODE_BASE/src/include/ddes/dms/* $GAUSSHOME/include/postgresql/server/ddes/dms/这样就能一下子把所有缺失的头文件都补全进去。
若出现 postgis_topology.c:249:54: error:base operand of '->' has non-pointer type 'FormData_pg_attribute' …的报错，则将 postgis-2.4.2/topology/postgis_topology.c 下249行的最后一个箭头操作符“->”改为点操作符“.”，然后重新编译。
topo->geometryOID = SPI_tuptable->tupdesc->attrs[3]->atttypid;改为：
topo->geometryOID = SPI_tuptable->tupdesc->attrs[3].atttypid;
5). omm用户执行下面的语句，完成PostGIS相关动态链接库在数据库实例节点中的分发。
mv $GAUSSHOME/lib/postgresql/postgis-2.4.so $GAUSSHOME/install/postgis-2.4.so python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/install/postgis-2.4.so $GAUSSHOME/lib/postgresql/postgis-2.4.so python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/install/json/lib/libjson-c.so.2 $GAUSSHOME/lib/libjson-c.so.2 python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/install/geos/lib/libgeos_c.so.1 $GAUSSHOME/lib/libgeos_c.so.1 python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/install/proj/lib/libproj.so.9 $GAUSSHOME/lib/libproj.so.9 python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/install/geos/lib/libgeos-3.6.2.so $GAUSSHOME/lib/libgeos-3.6.2.so python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/install/gdal/lib/libgdal.so.1.18.0 $GAUSSHOME/lib/libgdal.so.1 python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/install/postgis2.4.2/lib/liblwgeom-2.4.so.0 $GAUSSHOME/lib/liblwgeom-2.4.so.0 python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/postgis-xc/postgis-2.4.2/postgis--2.4.2.sql $GAUSSHOME/share/postgresql/extension/postgis--2.4.2.sql python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/postgis-xc/postgis-2.4.2/postgis.control $GAUSSHOME/share/postgresql/extension/postgis.control python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/bin/pgsql2shp $GAUSSHOME/bin/pgsql2shp python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/bin/shp2pgsql $GAUSSHOME/bin/shp2pgsql # 若未编译raster和topology部件，则不执行以下指令 python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/postgis-xc/postgis-2.4.2/postgis_raster--2.4.2.sql $GAUSSHOME/share/postgresql/extension/postgis_raster--2.4.2.sql python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/postgis-xc/postgis-2.4.2/postgis_raster.control $GAUSSHOME/share/postgresql/extension/postgis_raster.control python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/postgis-xc/postgis-2.4.2/extensions/postgis_topology/sql/postgis_topology--2.4.2.sql $GAUSSHOME/share/postgresql/extension/postgis_topology--2.4.2.sql python $GAUSSHOME/bin/transfer.py 1 $GAUSSHOME/postgis-xc/postgis-2.4.2/extensions/postgis_topology/postgis_topology.control $GAUSSHOME/share/postgresql/extension/postgis_topology.control动态链接库分发脚本执行完毕后，可执行下列命令删除$GAUSSHOME/postgis安装目录。
rm -rf $GAUSSHOME/postgis-xc若用户不想保留GCC7.3.0编译器，可删除GCC7.3.0安装目录并在~/.bashrc文件中删除安装GCC7.3.0时添加的环境配置信息。
rm -rf $GAUSSHOME/gcc6). 重启数据库实例。
gs_om -t stop && gs_om -t start -
PostGIS使用
创建Extension
创建PostGIS Extension可直接使用CREATE Extension命令进行创建：
openGauss=# CREATE Extension postgis;
使用Extension
PostGIS Extension函数调用格式为：
openGauss=# SELECT GisFunction (Param1, Param2,......);
其中GisFunction为函数名，Param1、Param2等为函数参数名。下列SQL语句展示PostGIS的简单使用，对于各函数的具体使用，请参考《PostGIS-2.4.2用户手册》。
示例1：几何表的创建。
openGauss=# CREATE TABLE cities ( id integer, city_name varchar(50) );
openGauss=# SELECT AddGeometryColumn('cities', 'position', 4326, 'POINT', 2);
示例2：几何数据的插入。
openGauss=# INSERT INTO cities (id, position, city_name) VALUES (1,ST_GeomFromText('POINT(-9.5 23)',4326),'CityA');
openGauss=# INSERT INTO cities (id, position, city_name) VALUES (2,ST_GeomFromText('POINT(-10.6 40.3)',4326),'CityB');
openGauss=# INSERT INTO cities (id, position, city_name) VALUES (3,ST_GeomFromText('POINT(20.8 30.3)',4326), 'CityC');
示例3：计算三个城市间任意两个城市距离。
openGauss=# SELECT p1.city_name,p2.city_name,ST_Distance(p1.position,p2.position) FROM cities AS p1, cities AS p2 WHERE p1.id > p2.id;
删除Extension
在openGauss中删除PostGIS Extension的方法如下所示：
openGauss=# DROP Extension postgis [CASCADE];
说明：
如果Extension被其它对象依赖（如创建的几何表），需要加入CASCADE（级联）关键字，删除所有依赖对象。
若要完全删除PostGIS Extension，则需由omm用户使用gs_om工具移除PostGIS及其依赖的动态链接库，格式如下：
gs_om -t postgis -m rmlibPostGIS支持和限制
支持数据类型
openGauss的PostGIS Extension支持如下数据类型：
- box2d
- box3d
- geometry_dump
- geometry
- geography
支持的操作符和函数列表
表 1 PostGIS Extension支持的操作符和函数列表
空间索引
openGauss数据库的PostGIS Extension支持GIST (Generalized Search Tree) 空间索引（分区表除外）。相比于B-tree索引，GIST索引适应于任意类型的非常规数据结构，可有效提高几何和地理数据信息的检索效率。
使用如下命令创建GIST索引：
openGauss=# CREATE INDEX indexname ON tablename USING GIST ( geometryfield );
扩展限制
- 只支持行存表。
- 不支持拓扑对象管理模块Topology和栅格数据处理模块Raster。
- 不支持BRIN索引。
- spatial_ref_sys表在扩容期间只支持查询操作。
439
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
