插件安装

操作场景

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

前提条件

安装插件前需要先将插件包上传至最终租户OBS中。插件包上传请参考上传对象章节。

注意事项

• 插件安装过程中会重启实例，将导致数据库业务短暂中断。
• 请联系第三方厂商获取相关插件包的下载地址、sha256以及license信息。
• 插件安装支持重复下发，首次安装插件要求配置license。
• 参数enable_default_ustore_table设置为off后，新建表的存储模式为Astore存储，存量表的存储模式不会改变。

约束限制

• 仅支持V2.0-8.100.0及以上版本实例。
• 实例状态或节点状态异常，则不允许进行插件安装。
• 插件安装后不支持卸载。
• 插件安装过程中不支持节点修复替换、扩容、热补丁升级等操作。
• 一个实例上最多支持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实例参数。
• HCE操作系统的实例当前未放开安装插件的能力。
• 分布式实例不支持安装插件。
• 容灾主备实例不支持安装postgis插件。

操作步骤

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

6. 选择插件名称，正确输入license、下载链接和SHA256，单击“确定”。
   图2 安装插件
   

   表1 参数说明

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

7. 查看安装结果。

   插件安装过程中，实例状态为“安装插件中”。插件安装完成后，实例状态为“正常”。插件安装完成后，如果在“配置信息”模块“插件”处显示出本次安装的插件名称，则本次插件安装成功。

   图3 查看安装结果