华为GaussDB数据库之Yukon安装与使用
一、Yukon简介
Yukon（禹贡），基于openGauss、PostgreSQL、GaussDB数据库扩展地理空间数据的存储和管理能力，提供专业的GIS（Geographic Information System）功能，赋能传统关系型数据库。
Yukon 支持二三维一体化的空间数据存储能力:
官网地址https://yukon.supermap.io/,此次我们基于华为GaussDB安装Yukon
二、软件版本
- 机器配置：8核16G，CPU: Huawei Kunpeng 920 2.9GHz
- 操作系统：EulerOS 2.8 64bit with ARM
- 数据库版本：GaussDB Kernel 505.1.0 build 44f4fa53
三、部署Yukon
- 请提前安装好GaussDB环境，具体安装方式请查看华为GaussDB数据库（单机版）在ARM环境下的安装指南
- 下载Yukon包：链接: https://pan.baidu.com/s/1tPPkFWTZjdOfyx4SnDjIgA?pwd=cykh 提取码: cykh
① 切换到omm用户
su omm
② 解压yukon安装包
tar -zxvf Yukon-2.0.2-GaussDB_505.1.B008_arm_20240228.tar.gz
③ 确认环境变量
--检查GAUSSHOME环境变量，输出结果是否为空以及是否正确
echo $GAUSSHOME
--检查PGDATA环境变量，输出结果是否为空以及是否正确
echo $PGDATA
--检查LD_LIBRARY_PATH环境变量，输出结果是否为空以及是否包含数据库lib目录
echo $LD_LIBRARY_PATH
④ 执行安装命令
cd yukon/
./install.sh -i
看到如下页面，Yukon安装成功
四、创建表空间、数据库、PostGIS扩展插件
① 启动数据库
gs_ctl start
使用上一章节创建的用户继续操作，如果没有请重新创建
② 登录数据库
gsql -d postgres -U zhangyongli -W supermap@123
创建新用户，需要提前设置omm密码，否则会报错
gsql -d postgres
ALTER ROLE "omm" PASSWORD 'supermap@123';
CREATE USER zhangyongli with PASSWORD 'supermap@123' SYSADMIN;
3.1 创建表空间
CREATE TABLESPACE testspace LOCATION '/home/omm/data';
注意：目录 /home/omm/data 必须已经存在且具有可访问权限。
3.2 创建数据库
CREATE DATABASE testdata ENCODING='UTF8' TABLESPACE=testspace;
3.3 创建PostGIS扩展插件
输入\q 退出，使用新的数据库登录，创建PostGIS扩展插件
gsql -d testdata -U zhangyongli -W supermap\@123
CREATE EXTENSION postgis;
== 提示 ==，如果不是用新创建的数据库登录，会报如下错误；如果确定用新用户登录的，无法创建可以尝试重启GaussDB数据库
gaussdb=> CREATE EXTENSION postgis;
ERROR: Extension is not a secure feature, and it may cause unexpected errors. using it need set enable_extension to true.
五、使用SuperMap iDesktopX测试
① 启动SuperMap iDesktopX 11i(2024)，数据源右键新建数据库型数据源
②输入用户名密码后，点击创建，当创建成功后，则证明基础环境搭建完成
至此安装Yukon安装成功。
六、可能遇到的问题
6.1 iDesktopX创建Yukon数据源失败，
由于iDesktopX创建时依赖libpcre16，如果当前环境中没有安装会导致创建数据源失败（EulerOS 2.8没有）
检查是否有缺失，可以通过以下命令：
cd /home/omm/package/lib/gaussdb
ldd yukon_geomodel-1.0.so | grep not
手动安装，需要root用户安装
su - root
yum install pcre-utf16
安装完成后，不需要重启GaussDB数据库，直接再次使用iDesktopX创建
6.2 创建PostGIS插件时，报"could not open extension control file: No such file or directory"错误
问题原因：该问题是没有安装Yukon，应该先安装Yukon，再创建PostGIS插件。
解决办法：另开一个窗口，把Yukon安装好，然后在回到这个窗口再次执行
6.3 创建PostGIS插件时，报"ERROR:could not load library "postgis-3.so": /home/omm/package/lib/gaussdb/postgis-3.so: cannot open shared object file: No such file or directory"
问题原因：
- 检查环境变量是否配置成功，检查/home/omm/package/lib/gaussdb/这个目录下postgis-3.so文件是否存在，是否有权限。
- 检查是否是安装错Yukon包了，例如将X86安装在ARM环境中
（转发请注明出处：http://www.cnblogs.com/zhangyongli2011/ 如发现有错，请留言，谢谢）
