=============== ALTER EXTENSION =============== .. container:: refentry :name: SQL-ALTEREXTENSION .. container:: titlepage .. container:: refnamediv .. rubric:: ALTER EXTENSION :name: alter-extension ALTER EXTENSION — 更改一个扩展的定义 .. container:: refsynopsisdiv .. rubric:: 大纲 :name: 大纲 .. code:: 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 其中 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 [ , ... ] .. container:: refsect1 :name: id-1.9.3.11.5 .. rubric:: 描述 :name: 描述 ``ALTER EXTENSION``\ 更改一个已安装扩展的定义。 有几种子形式： .. container:: variablelist ``UPDATE`` 这种形式把该扩展更新到一个新版本。该扩展必须提供一个适当的更新 脚本（或者一系列脚本）来把当前已安装的版本修改成所要求的版本。 ``SET SCHEMA`` 这种形式把该扩展的对象移动到另一个模式中。要使这个命令成功，该扩展 必须是\ *可重定位的*\ 。 ``ADD member_object`` 这种形式把一个现有的对象加入到该扩展中。这主要对扩展更新脚本有用。 该对象后续将被当作该扩展的一个成员。尤其是该对象只有通过删除扩展 才能删除。 ``DROP member_object`` 这种形式从该扩展移除一个成员对象。这主要对扩展更新脚本有用。只有 撤销该对象与其扩展之间的关联后才能删除该对象。 要使用\ ``ALTER EXTENSION``\ ，你必须拥有该扩展。 ``ADD``/``DROP``\ 形式还要求被增加/删除对象的所有权。 .. container:: refsect1 :name: id-1.9.3.11.6 .. rubric:: 参数 :name: 参数 .. container:: variablelist ``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`` 该转换的语言的名称。 .. container:: refsect1 :name: id-1.9.3.11.7 .. rubric:: 示例 :name: 示例 把\ ``hstore``\ 扩展更新到版本 2.0： .. code:: programlisting ALTER EXTENSION hstore UPDATE TO '2.0'; 把\ ``hstore``\ 扩展的模式更改到\ ``utils``\ ： .. code:: programlisting ALTER EXTENSION hstore SET SCHEMA utils; 要向\ ``hstore``\ 扩展增加一个现有函数： .. code:: programlisting ALTER EXTENSION hstore ADD FUNCTION populate_record(anyelement, hstore); .. container:: refsect1 :name: id-1.9.3.11.8 .. rubric:: 兼容性 :name: 兼容性 ``ALTER EXTENSION``\ 是一个 OushuDB 扩展。 .. container:: refsect1 :name: SQL-ALTEREXTENSION-SEE-ALSO .. rubric:: 另见 :name: 另见 `CREATE EXTENSION `__, `DROP EXTENSION `__