ALTER EXTENSION

更改在 YMatrix 数据库中注册的扩展的定义。

概要

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 |
  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

  • 这种形式从扩展中删除一个成员对象。这这主要对扩展更新脚本有用。只有 撤销该对象与其扩展之间的关联后才能删除该对象。

用户必须对扩展有所有权才可以使用 ALTER EXTENSION。ADD 和 DROP 形式也要求对需要增加或者删除的对象有所有权。

参数

name

  • 需要安装的扩展名

new_version

  • 新版本的扩展。new_version 以是标识符或字符串文字。如果未指定,该命令将尝试更新到扩展控制文件中的默认版本。

new_schema

  • 扩展的新模式。

object_name

aggregate_name

function_name

operator_name

  • 要从该扩展增加或者移除的对象的名称。表、聚集、域、外部表、函数、 操作符、操作符类、操作符族、序列、文本搜索对象、类型和视图的名称 可以被方案限定。

source_type

  • 需要转换的源数据类型的名称。

target_type

  • 需要转换的目标数据类型的名称。

argmode

  • 函数或聚集参数的模型:IN, OUT, INOUT, 或者 VARIADIC。默认值是 IN。
    这个命令会忽略掉OUT 参数。只需要输入参数才决定标识一个函数。这足够列出 IN, INOUT和 VARIADIC 参数。

argname

  • 函数或聚集参数的名字。
    这个命令会忽略掉参数的名字,因为参数的数据类型已经决定标识一个函数了。

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 是一个 YMatrix 数据库的扩展

另见

CREATE EXTENSION , DROP EXTENSION