ALTER EXTENSION

ALTER EXTENSION —更改 extensions 的定义

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 [ , ... ]

Description

ALTER EXTENSION更改已安装扩展的定义。有几个子窗体：

• UPDATE

  • 该表格将 extensions 更新为较新的版本。extensions 必须提供合适的更新脚本(或一系列脚本)，可以将当前安装的版本修改为请求的版本。

• SET SCHEMA

  • 这种形式将扩展的对象移动到另一个架构中。该 extensions 必须是“可重定位”的，此命令才能成功。

• ADD member_object

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

• DROP member_object

  • 此表单从 extensions 中删除成员对象。这主要在扩展更新脚本中有用。该对象不会被删除，仅与 extensions 无关。

有关这些操作的更多信息，请参见Section 38.16。

您必须拥有 extensions 才能使用ALTER EXTENSION。 ADD/DROP表单也需要添加/删除对象的所有权。

Parameters

• name

  • 已安装扩展的名称。

• new_version

  • 所需的扩展新版本。可以将其写为标识符或字符串 Literals。如果未指定，则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参数，因为只需要 Importing 参数即可确定函数的身份。因此，列出IN，INOUT和VARIADIC参数就足够了。

• argname

  • 函数，过程或聚合参数的名称。注意ALTER EXTENSION实际上并没有注意参数名称，因为只需要参数数据类型即可确定函数的身份。

• argtype

  • 函数，过程或聚合参数的数据类型。

• left_type
right_type

  • 运算符参数的数据类型(可选，模式限定)。ImportingNONE作为前缀或后缀运算符的缺少参数。

• PROCEDURAL

  • 这是一个干扰词。

• type_name

  • 转换的数据类型的名称。

• lang_name

  • 转换语言的名称。

Examples

要将hstoreextensions 更新到版本 2.0：

ALTER EXTENSION hstore UPDATE TO '2.0';

要将hstoreextensions 的架构更改为utils：

ALTER EXTENSION hstore SET SCHEMA utils;

要将现有功能添加到hstoreextensions：

ALTER EXTENSION hstore ADD FUNCTION populate_record(anyelement, hstore);

Compatibility

ALTER EXTENSION是 PostgreSQL 扩展。

See Also

CREATE EXTENSION, DROP EXTENSION