PostgreSQL ALTER EXTENSION
ALTER EXTENSION — 更改一个扩展的定义
大纲
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 |
PROCEDURE procedure_name
[ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] |
ROUTINE routine_name [ ( [ [ argmode ] [ argname ]
argtype [, ...] ] ) ] |
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
-
这种形式从该扩展移除一个成员对象。这主要对扩展更新脚本有用。只有 撤销该对象与其扩展之间的关联后才能删除该对象。
关于这些操作详见第 37.17 节。
要使用ALTER EXTENSION
,你必须拥有该扩展。 ADD
/DROP
形式还要求被增加/删除对象的所有权。
参数
name
-
一个已安装扩展的名称。
new_version
-
想要得到的该扩展的新版本。这可以写成一个标识符或者一个字符串。如果没有指定,
ALTER EXTENSION UPDATE
会尝试更新到该扩展的控制文件中的 默认版本。 new_schema
-
该扩展的新模式。
object_name
aggregate_name
function_name
operator_name
procedure_name
routine_name
-
要从该扩展增加或者移除的对象的名称。表、聚集、域、外部表、函数、 操作符、操作符类、操作符族、过程、例程、序列、文本搜索对象、类型和视图的名称 可以被模式限定。
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
。 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
是一个PostgreSQL
扩展。