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

where member_object is:

  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

and aggregate_signature is:

* |
[ argmode ] [ argname ] argtype [ , ... ] |
[ [ argmode ] [ argname ] argtype [ , ... ] ] ORDER BY [ argmode ] [ argname ] argtype [ , ... ]

描述

ALTER EXTENSION更改已安装扩展的定义。有几个子形式

UPDATE

此形式将扩展更新到较新版本。扩展必须提供一个合适的更新脚本（或一系列脚本），可以将当前安装的版本修改为请求的版本。

SET SCHEMA

此形式将扩展的对象移动到另一个模式。扩展必须是可重定位的，此命令才能成功。

添加 member_object

此表单将现有对象添加到扩展中。这主要在扩展更新脚本中很有用。随后，该对象将被视为扩展的成员；值得注意的是，它只能通过删除扩展来删除。

删除 member_object

此表单从扩展中删除成员对象。这主要在扩展更新脚本中很有用。对象不会被删除，只会与扩展解除关联。

请参阅第 38.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扩展。

另请参见

CREATE EXTENSION，DROP EXTENSION