注意事项

创建扩展

安装一个扩展,Yukon目前共提供 postgis、postgis_raster、postgis_sfcgal、yukon_geomodel、yukon_geogridcoder五个扩展，postgis为基础扩展，被其他扩展依赖，因此安装其他扩展之前请先安装基础扩展;

语法

PostgreSQL

CREATE EXTENSION [ IF NOT EXISTS ] extension_name
    [ WITH ] [ SCHEMA schema_name ]
    [ VERSION version ]
    [ CASCADE ]

openGauss/GaussDB

CREATE EXTENSION [ IF NOT EXISTS ] extension_name
    [ WITH ] [ SCHEMA schema_name ]
             [ VERSION version ]
             [ FROM old_version ]

参数说明

IF NOT EXISTS

如果系统已经存在一个同名的扩展，不会报错。这种情况下会给出一个提示。请注意该参数不保证系统存在的扩展和现在脚本创建的扩展相同。

extension_name

将被安装扩展的名字。

schema_name

扩展的实例被安装在该模式下，扩展的内容可以被重新安装。指定的模式必须已经存在，如果没有指定，扩展的控制文件也不指定一个模式，这样将使用默认模式。

Note

注意：扩展不认为它在任何模式里面：扩展在一个数据库范围内的名字是不受限制的，但是一个扩展的实例是属于一个模式的。

version

安装扩展的版本，可以写为一个标识符或者字符串.默认的版本在扩展的控制文件中指定。

CASCADE

自动安装此扩展所依赖但尚未安装的任何扩展。它们的依赖项同样以递归方式自动安装。该子句（如果给定）适用于以这种方式安装的所有扩展。语句的其他选项不适用于自动安装的扩展;特别是，始终选择其默认版本

old_version

当你想升级安装“old style” 模块中没有的内容时,你必须指定FROM old_version。这个选项使CREATE EXTENSION 运行一个安装脚本将新的内容安装到扩展中，而不是创建一个新的实体.注意SCHEMA指定了包括这些已存在实体的模式。

示例

--在当前数据库安装postgis扩展
CREATE EXTENSION postgis;

--在当前数据库安装postgis扩展到指定模式下
CREATE EXTENSION postgis with schema schema_name;

注意事项

1、部分模块在扩展时需要与PostGIS在相同的模式下，否则无法扩展，遇到该情况需要使用[ WITH ] [ SCHEMA schema_name ]指定扩展所属SCHEMA，根据提示扩展到PostGIS相同模式下。目前postgis_raster、pgrouting、yukon_geogridcoder均需要与PostGIS在相同的模式下。

2、添加扩展后，如果需要用户在非扩展注册所属的模式（schema）下访问yukon函数和类型时，默认情况下不指定模式无法访问，必须指定模式,解决方法详情参考’openGauss/GaussDB 相关模式（schema）说明’。

Note

openGauss/GaussDB非初始化用户扩展时不支持public，使用 [ WITH ] [ SCHEMA schema_name ] 参数添加扩展，如果需要扩展到public下，必须使用数据库初始化用户进行扩展，解决权限有关问题； GaussDB有yukon_geogridcoder、yukon_geomodel、yukon_vector_pyramid三个试用模块，创建试用模块的扩展需要启用enable_extension参数，可尝试在数据库中执行”set enable_extension=on”。

移除扩展

Yukon支持从数据库移除扩展模块。

语法

DROP EXTENSION [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]

示例

移除postgis扩展：

DROP EXTENSION postgis;

– 如果有对象依赖该扩展，需要加CASCADE关键字进行级联删除

DROP EXTENSION postgis CASCADE;

注意事项

该能力由数据库内核提供，移除扩展将从当前数据库中删除指定扩展模块的相关配置，如果使用CASCADE同时将自动删除依赖于该扩展的对象，其中包括与该模块相关的数据，依赖于此模块的其他扩展和数据，建议谨慎使用，提前做好相关数据备份。参考 DROP EXTENSION 语法

openGauss需要启用兼容参数，在数据库中执行”ALTER SYSTEM SET support_extended_features to on “并根据提示重启数据库，才能正常移除扩展，参考 openGauss文档