插件安装

操作场景

Yukon是超图公司开发的一款GIS插件，可以扩展地理空间数据的存储和管理能力，支持二三维一体化的空间数据存储能力，提供专业的GIS（Geographic Information System）功能，赋能传统关系型数据库。有关插件的详细介绍，请参考“云商店 >服务支持 >Yukon产品文档”。

GaussDB提供实例内核插件（仅支持Yukon提供的postgis）安装功能，从而实现内核功能增强。

前提条件

• 已在云商店购买License，并联系第三方厂商获取插件包的下载地址以及sha256信息。联系信息参见“云商店 >服务支持 >服务信息”模块。
• 安装插件前需要先将插件包上传至最终租户OBS中。插件包上传请参考上传对象章节。

注意事项

• 插件安装过程中会重启实例，将导致数据库业务短暂中断。
• 插件安装支持重复下发，首次安装插件要求配置License。
• 参数enable_default_ustore_table设置为off后，新建表的存储模式为Astore存储，存量表的存储模式不会改变。
• 数据库版本与GIS插件版本有强配套关系，请使用配套版本进行安装。

约束限制

• 支持 V2.0-8.218及以上实例。
• 实例状态或节点状态异常，则不允许进行插件安装。
• 插件安装后不支持卸载。
• 插件安装过程中不支持节点修复替换、扩容、热补丁升级等操作。
• Yukon GIS插件版本与数据库实例版本强配套，如果升级数据库实例版本，会导致已安装的GIS插件功能不可用，控制台暂不支持升级GIS插件。
• 一个实例上最多支持200个库开启或关闭扩展，一次开启或关闭最多支持10个库同时操作。
• 在使用postgis插件前需要检查参数behavior_compat_options的值，如果behavior_compat_options值包含allow_procedure_compile_check、proc_implicit_for_loop_variable、proc_outparam_override任意一个，则可能会出现无法使用的情况。可以通过控制台界面修改参数值，详情请参见修改GaussDB实例参数。
• 在使用postgis插件前需要检查参数enable_default_ustore_table、forbid_public_funcname_same_with_sysfunc是否为off，如果为on则无法使用。可以通过控制台界面修改参数值为off，详情请参见修改GaussDB实例参数。
• 在使用postgis插件前需要检查参数enable_astore_gist是否为on，如果为off则无法使用GIST索引功能。可以通过控制台界面修改参数值为on，详情请参见修改GaussDB实例参数。
• 容灾主备实例不支持安装postgis插件。

操作步骤

1. 登录管理控制台。
2. 单击管理控制台左上角的，选择区域和项目。
3. 在页面左上角单击，选择“数据库 > 云数据库 GaussDB”，进入云数据库 GaussDB信息页面。
4. 在“实例管理”页面，选择指定的实例，单击实例名称，进入实例的“基本信息”页签。
5. 在左侧导航栏单击“插件管理”。
6. 单击postgis插件操作列的“安装”。
   图1 安装postgis插件
   

7. 输入正确的license、下载链接和SHA256，单击“确定”。
   图2 安装插件
   

   表1 参数说明

   参数	描述
   license	提供ESN给第三方厂商，用于获取license文件，其中ESN号是需要安装插件的实例ID。
   插件名称	安装的插件名称，默认插件名为postgis。
   下载链接	插件包在OBS中的分享链接。 获取方式请参考通过对象URL访问对象。
   SHA256	第三方厂商提供的SHA256。

8. 查看安装结果。

   插件安装过程中，实例状态为“安装插件中”。插件安装完成后，实例状态为“正常”。在“插件管理”模块，postgis插件“是否安装”列值为“是”，则本次插件安装成功。

   图3 查看安装结果