# 插件安装 #### 操作场景 Yukon是超图公司开发的一款GIS插件，可以扩展地理空间数据的存储和管理能力，支持二三维一体化的空间数据存储能力，提供专业的GIS（Geographic Information System）功能，赋能传统关系型数据库。有关插件的详细介绍，请参考"[云商店](https://marketplace.huaweicloud.com/contents/8f3c73fa-0a58-4fc9-8136-02eb1b8146c7#productid=OFFI1225647236272160768) \> Yukon产品文档"。 GaussDB提供实例内核插件（仅支持Yukon提供的postgis）安装功能，从而实现内核功能增强。 #### 前提条件 - 已在[云商店](https://marketplace.huaweicloud.com/contents/8f3c73fa-0a58-4fc9-8136-02eb1b8146c7#productid=OFFI1225647236272160768)购买License，并联系第三方厂商获取插件包的下载地址以及sha256信息。联系信息参见"[云商店](https://marketplace.huaweicloud.com/contents/8f3c73fa-0a58-4fc9-8136-02eb1b8146c7#productid=OFFI1225647236272160768) \>服务支持 \>服务信息"模块。 - 安装插件前需要先将插件包上传至最终租户OBS中。插件包上传请参考[上传对象](https://support.huaweicloud.com/usermanual-obs/obs_03_1002.html)章节。 #### 注意事项 - 插件安装过程中会重启实例，将导致数据库业务短暂中断。 - 插件安装支持重复下发，首次安装插件要求配置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实例参数](https://support.huaweicloud.com/usermanual-gaussdb/gaussdb_01_166.html)。 - 在使用postgis插件前需要检查参数enable_default_ustore_table、forbid_public_funcname_same_with_sysfunc是否为off，如果为on则无法使用。可以通过控制台界面修改参数值为off，详情请参见[修改GaussDB实例参数](https://support.huaweicloud.com/usermanual-gaussdb/gaussdb_01_166.html)。 - 在使用postgis插件前需要检查参数enable_astore_gist是否为on，如果为off则无法使用GIST索引功能。可以通过控制台界面修改参数值为on，详情请参见[修改GaussDB实例参数](https://support.huaweicloud.com/usermanual-gaussdb/gaussdb_01_166.html)。 - 容灾主备实例不支持安装postgis插件。 #### 操作步骤 1. [登录云数据库GaussDB控制台](https://console.huaweicloud.com/gaussdb/?locale=zh-cn#/gaussdb/management/list)。 2. 在"实例管理"页面，选择指定的实例，单击实例名称，进入实例的"基本信息"页签。 3. 在左侧导航栏单击"插件管理"。 4. 单击postgis插件操作列的"安装"。 图1安装postgis插件 ![](https://support.huaweicloud.com/usermanual-gaussdb/figure/zh-cn_image_0000002679853917.png "点击放大") 5. 输入正确的license、下载链接和SHA256，单击"确定"。 图2安装插件 ![](https://support.huaweicloud.com/usermanual-gaussdb/figure/zh-cn_image_0000002679853919.png "点击放大") 表1参数说明 | 参数 | 描述 | |:---|:---| | license | 提供ESN给第三方厂商，用于获取license文件，其中ESN号是需要安装插件的实例ID。 | | 插件名称 | 安装的插件名称，默认插件名为postgis。 | | 下载链接 | 插件包在OBS中的分享链接。 获取方式请参考[通过URL访问对象](https://support.huaweicloud.com/usermanual-obs/obs_03_0319.html)。 | | SHA256 | 第三方厂商提供的SHA256。 | 6. 查看安装结果。 插件安装过程中，实例状态为"安装插件中"。插件安装完成后，实例状态为"正常"。在"插件管理"模块，postgis插件"是否安装"列值为"是"，则本次插件安装成功。 图3查看安装结果 ![](https://support.huaweicloud.com/usermanual-gaussdb/figure/zh-cn_image_0000002680013753.png "点击放大")