ALTER EXTENSION

ALTER EXTENSION
上一页	上一级	SQL 命令	首页	下一页

ALTER EXTENSION — 更改一个扩展的定义

Synopsis

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: 这种形式把该扩展的对象移动到另一个模式中。要使这个命令成功，该扩展必须是可重定位的。
ADD member_object: 这种形式把一个现有的对象添加到该扩展中。这主要在扩展更新脚本中有用。此后该对象将被视为该扩展的一个成员；特别地，只能通过删除该扩展来删除它。
DROP member_object: 这种形式从该扩展中移除一个成员对象。这主要在扩展更新脚本中有用。该对象不会被删除，只是与该扩展解除关联。

See Section 36.17 for more information about these operations.

你必须拥有该扩展才能使用 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