选择 打开 改范围 完整检索页
受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11
当前 PostgreSQL 版本不在支持生命周期内。
您可以参阅当前版本的对应页面,或其他在上面列出的活跃大版本。

ALTER PROCEDURE

ALTER PROCEDURE — 更改过程的定义

Synopsis

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_USER | SESSION_USER }
ALTER PROCEDURE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
    SET SCHEMA new_schema
ALTER PROCEDURE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
    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

参数的模式:INVARIADIC。如果省略,默认值为IN

argname

参数的名称。请注意,ALTER PROCEDURE实际上不会关注参数名称,因为确定过程身份只需要参数数据类型。

argtype

过程参数的数据类型(如果有,可带模式限定)。

new_name

该过程的新名称。

new_owner

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

new_schema

该过程的新模式。

extension_name

该过程所依赖的扩展名称。

[ EXTERNAL ] SECURITY INVOKER
[ EXTERNAL ] SECURITY DEFINER

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

configuration_parameter
value

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

关于允许的参数名和值的更多信息,请参见 SETChapter 19

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中是可选的。