ALTER EXTENSION
ALTER EXTENSION¶
更改在SeaboxMPP数据库中注册的扩展的定义。
- 语法
-
``` sql ALTER EXTENSION name UPDATE [ TO new_version ] ALTER EXTENSION name SET SCHEMA new_schema ALTER EXTENSION name ADD member_object ALTER EXTENSION name DROP member_object
member_object 为:
ACCESS METHOD object_name | AGGREGATE aggregate_name ( aggregate_signature ) | CAST (source_type AS target_type) | COLLATION object_name | CONVERSION object_name | DOMAIN object_name | EVENT TRIGGER object_name | FOREIGN DATA WRAPPER object_name | FOREIGN TABLE object_name | FUNCTION function_name ( [ [ argmode ] [ argname ] 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 | TRANSFORM FOR type_name LANGUAGE lang_name | TYPE object_name | VIEW object_name
aggregate_signature为:
- | [ argmode ] [ argname ] argtype [ , … ] | [ [ argmode ] [ argname ] argtype [ , … ] ] ORDER BY [ argmode ] [ argname ] argtype [ , … ] ```
- 描述
-
ALTER EXTENSION
更改已安装扩展的定义。 有几种子形式:UPDATE
- 此形式将扩展更新到一个较新版本。该扩展必须提供一个合适的更新脚本(或一系列脚本),可以将当前安装的版本修改为所要求的版本。
SET SCHEMA
- 这种形式将扩展对象移动到另一个模式中。扩展名必须是
可重定位的
。 ADD member_object
- 这种形式将一个现有对象添加到该扩展中。这在扩展更新脚本中很有用。 该对象后续将被当作该扩展的一个成员。尤其是该对象只有通过删除扩展才能删除。
DROP member_object
- 这种形式从扩展中删除一个成员对象。这主要对扩展更新脚本有用。只有撤销该对象与其扩展之间的关联后才能删除该对象。
用户必须对扩展有所有权才可以使用
ALTER EXTENSION
。ADD
和DROP
形式也要求对需要增加或者删除的对象有所有权。 - 参数
-
该SQL命令参数说明见下
name
- 需要安装的扩展名
new_version
- 新版本的扩展。
new_version
以是标识符或字符串文字。如果未指定,该命令将尝试更新到扩展控制文件中的默认版本。
new_schema
扩展的新模式。object_name|aggregate_name|function_name|operator_name
- 要从该扩展增加或者移除的对象的名称。表、聚集、域、外部表、函数、 操作符、操作符类、操作符族、序列、文本搜索对象、类型和视图的名称 可以被方案限定。
source_type
- 需要转换的源数据类型的名称。
target_type
- 需要转换的目标数据类型的名称。
argmode
-
函数或聚集参数的模型:
IN
,OUT
,INOUT
, 或者VARIADIC
。默认值是IN
.这个命令会忽略掉
OUT
参数。只需要输入参数才决定标识一个函数。这足够列出IN
, INOUT和
VARIADIC`参数。 argname
-
函数或聚集参数的名字。
这个命令会忽略掉参数的名字,因为参数的数据类型已经决定标识一个函数了。
argtype
- 函数或者聚集参数的数据类型。
left_type|right_type
- 操作符参数的数据类型(可以是方案限定)。一个前缀或后缀操作符的缺省参数可写作
NONE
。 PROCEDURAL
- 这是一个噪声词。
type_name
- 该转换的数据类型的名称。
lang_name
- 该转换的语言的名称。
- 示例
-
将hstore更新到2.0版本:
ALTER EXTENSION hstore UPDATE TO '2.0';
将
hstore
扩展的模式更改为utils
:ALTER EXTENSION hstore SET SCHEMA utils;
将一个已存在的函数添加到
hstore
扩展:ALTER EXTENSION hstore ADD FUNCTION populate_record(anyelement, hstore);
- 兼容性说明
ALTER EXTENSION
是一个SeaboxMPP数据库的扩展- 相关SQL命令
CREATE EXTENSION
,DROP EXTENSION