ALTER EXTENSION
- 扩展功能为内部使用功能,只允许修改数据库内部的高级包或扩展。
- 要使用该功能,需要设置support_extended_features为true。
功能描述
修改已安装扩展的属性。
注意事项
语法格式
- 修改扩展的版本。
ALTER EXTENSION name UPDATE [ TO new_version ];

- 修改扩展的模式。
ALTER EXTENSION name SET SCHEMA new_schema;

- 添加或删除扩展的成员对象。
ALTER EXTENSION name { ADD | DROP } member_object;
其中成员对象member_object写法为:
{AGGREGATE agg_name (agg_type [, ...] ) | CAST (source_type AS target_type) | COLLATION object_name | CONVERSION object_name | EVENT TRIGGER object_name | FOREIGN DATA WRAPPER object_name | FOREIGN TABLE object_name | FUNCTION function_name ( [ [ argname ] [ argmode ] argtype [, ...] ] ) | MATERIALIZED VIEW object_name | OPERATOR operator_name (left_type, right_type) | OPERATOR CLASS object_name USING index_method | OPERATOR FAMILY object_name USING index_method | [ PROCEDURAL ] LANGUAGE object_name | SCHEMA object_name | SEQUENCE object_name | SERVER object_name | TABLE object_name | TEXT SEARCH CONFIGURATION object_name | TEXT SEARCH DICTIONARY object_name | TEXT SEARCH PARSER object_name | TEXT SEARCH TEMPLATE object_name | TYPE object_name | VIEW object_name}
参数说明
- name
已安装扩展的名称。
- new_version
扩展的新版本。可以通过被标识符和字面字符重写。如果不指定的扩展的新版本,ALTER EXTENSION UPDATE会更新到扩展的控制文件中显示的默认版本。
- new_schema
扩展的新模式。
- object_name | agg_name | function_name | operator_name
从扩展里被添加或移除的对象的名称。包含表、聚合、外链表、函数、操作符、操作符类、操作符族、序列、文本搜索对象、类型和能被模式合格的视图的名称。
- agg_type
在聚合函数操作上的一个输入数据类型。当引用一个零参数聚合函数,使用*代替这些零参数聚合函数的输入数据类型列表。
- source_type
强制转换的源数据类型的名称。
- target_type
强制转换的目标数据类型的名称。
- argmode
这个函数参数的模型。
取值范围:IN、OUT、INOUT或者VARIADIC。未指定时默认值为IN。
ALTER EXTENSION操作中,并不关心OUT参数,由于确认函数的一致性只需要输入参数,因此仅指定IN、INOUT和VARIADIC参数即可。
- argname
函数参数的名称。
ALTER EXTENSION操作中,并不关心参数名称,确认函数的一致性只需要确认参数数据类型即可。
- argtype
函数参数的数据类型(可以有模式修饰)。
- left_type | right_type
操作符参数的数据类型,可以使用模式进行具体指定,为前缀或后缀运算符的丢失参数写NONE。
示例
更新plpgsql扩展到版本2.0:
gaussdb=# ALTER EXTENSION plpgsql UPDATE TO '2.0';
更新plpgsql扩展的模式为utils:
--创建SCHEMA。 gaussdb=# CREATE SCHEMA utils; --更新 plpgsql 扩展的模式为utils。 gaussdb=# ALTER EXTENSION plpgsql SET SCHEMA utils; --删除SCHEMA。 gaussdb=# DROP SCHEMA utils;
添加一个已存在的函数给 plpgsql 扩展:
gaussdb=# ALTER EXTENSION plpgsql ADD FUNCTION populate_record(anyelement, plpgsql);