ALTER PROCEDURE

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

开发中的版本： 19 / 20devel

已结束支持的版本： 13 / 12 / 11

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

ALTER PROCEDURE — 更改过程的定义

大纲

ALTER PROCEDURE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
    action [ ... ] [ RESTRICT ]
ALTER PROCEDURE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
    RENAME TO new_name
ALTER PROCEDURE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
    OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER PROCEDURE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
    SET SCHEMA new_schema
ALTER PROCEDURE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
    [ NO ] DEPENDS ON EXTENSION extension_name

其中 action 是以下之一：

    [ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER
    SET configuration_parameter { TO | = } { value | DEFAULT }
    SET configuration_parameter FROM CURRENT
    RESET configuration_parameter
    RESET ALL

描述

ALTER PROCEDURE 更改过程的定义。

要使用 ALTER PROCEDURE，必须拥有该过程。要更改过程的模式，还必须在新模式上拥有 CREATE 权限。要更改所有者，还必须是新所有者角色的直接或间接成员，并且该角色必须在过程所在模式上拥有 CREATE 权限。（这些限制确保更改所有者不会执行任何无法通过删除并重新创建过程完成的操作。不过，超级用户无论如何都可以更改任何过程的所有权。）

参数

name #

现有过程的名称（可带模式限定）。如果未指定参数列表，该名称在其模式中必须唯一。

argmode #

参数的模式：IN、OUT、INOUT 或 VARIADIC。如果省略，默认为 IN。

argname #

参数名称。注意，ALTER PROCEDURE 实际上并不关心参数名，因为确定过程标识时只使用参数数据类型。

argtype #

过程参数的数据类型（如果有，可带模式限定）。关于如何根据参数数据类型查找过程的详细信息，请参见 DROP PROCEDURE。

new_name #

该过程的新名称。

new_owner #

该过程的新拥有者。注意，如果该过程被标记为 SECURITY DEFINER，随后它将以新拥有者的身份执行。

new_schema #

该过程的新模式。

extension_name #

这种形式将过程标记为依赖于该扩展；如果指定了 NO，则表示不再依赖该扩展。被标记为依赖扩展的过程会在扩展被删除时一并删除，即使没有指定 CASCADE 也是如此。一个过程可以依赖多个扩展，其中任意一个扩展被删除时，该过程都会被删除。

[ EXTERNAL ] SECURITY INVOKER [ EXTERNAL ] SECURITY DEFINER #

更改该过程是否为安全性定义者。关键字 EXTERNAL 为符合 SQL 标准而被忽略。关于这一能力的更多信息，参见 CREATE PROCEDURE。

configuration_parameter value #

添加或更改在调用该过程时要赋给某个配置参数的值。如果 value 为 DEFAULT，或者等效地使用了 RESET，则会移除过程局部设置，这样该过程就会使用其环境中的值执行。使用 RESET ALL 可以清除所有过程局部设置。SET FROM CURRENT 会将执行 ALTER PROCEDURE 时该参数的当前值保存为进入该过程时要应用的值。

关于允许的参数名和值的更多信息，请参见 SET 和第 20 章。

RESTRICT #

为符合 SQL 标准而被忽略。

示例

要将具有两个 integer 类型参数的过程 insert_data 重命名为 insert_record：

ALTER PROCEDURE insert_data(integer, integer) RENAME TO insert_record;

要将具有两个 integer 类型参数的过程 insert_data 的拥有者改为 joe：

ALTER PROCEDURE insert_data(integer, integer) OWNER TO joe;

要将具有两个 integer 类型参数的过程 insert_data 的模式改为 accounting：

ALTER PROCEDURE insert_data(integer, integer) SET SCHEMA accounting;

要将过程 insert_data(integer, integer) 标记为依赖于扩展 myext：

ALTER PROCEDURE insert_data(integer, integer) DEPENDS ON EXTENSION myext;

要调整会为过程自动设置的搜索路径：

ALTER PROCEDURE check_password(text) SET search_path = admin, pg_temp;

要禁用过程的 search_path 自动设置：

ALTER PROCEDURE check_password(text) RESET search_path;

现在该过程将使用其调用者所使用的任何搜索路径执行。

兼容性

该语句与 SQL 标准中的 ALTER PROCEDURE 语句部分兼容。标准允许修改过程的更多属性，但不提供重命名过程、将过程设为安全性定义者、为过程附加配置参数值，或者更改过程的拥有者或模式的能力。标准还要求使用 RESTRICT 关键字，而它在 PostgreSQL 中是可选的。

另见

CREATE PROCEDURE, DROP PROCEDURE, ALTER FUNCTION, ALTER ROUTINE

上一页	上一级	下一页
ALTER POLICY	起始页	ALTER PUBLICATION

报告文档问题

阅读上游文档. 通过 PostgreSQL 文档反馈表单.