ALTER EXTENSION

支持中的版本：当前版本 (18) / 17 / 16 / 15 / 14

开发中的版本： 19 / 20devel

已结束支持的版本： 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1

开发快照。 PostgreSQL 20devel 尚未正式发布，内容仍可能变化。

ALTER EXTENSION
上一页	上一级	SQL 命令	起始页	下一页

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 #: 这种形式从扩展中移除一个成员对象。这主要在扩展更新脚本中有用。该对象不会被删除，而只是与扩展解除关联。

有关这些操作的更多信息，见第 36.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

上一页	上一级	下一页
ALTER EVENT TRIGGER	起始页	ALTER FOREIGN DATA WRAPPER

报告文档问题

阅读上游文档. 反馈更正前请先核对当前版本手册.