PostgreSQL 17 文档: ALTER EXTENSION

ALTER EXTENSION
上一个	上	SQL 命令	主页	下一个

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: 此形式将扩展的对象移动到另一个模式中。扩展必须是可重新定位的才能够成功执行此命令。
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