ALTER PROCEDURE

ALTER PROCEDURE
上一页	上一级	SQL 命令	首页	下一页

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

where action is one of:

    [ 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 特权。要更改拥有者，你必须能够 SET ROLE 到新的拥有角色，并且该角色必须在该过程的模式上具有 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 时）不再依赖于该扩展。被标记为依赖于某个扩展的过程会在该扩展被删除时被删除，即使没有指定级联也是如此。一个过程可以依赖于多个扩展，并且在其中任何一个扩展被删除时都会被删除。

[ EXTERNAL ] SECURITY INVOKER [ EXTERNAL ] SECURITY DEFINER

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

configuration_parameter value

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

有关允许的参数名称和值的更多信息，请参见 SET 和 Chapter 19。

RESTRICT

为了符合 SQL 标准而被忽略。

示例

把过程 insert_data（具有两个 integer 类型的参数）重命名为 insert_record：

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

把过程 insert_data（具有两个 integer 类型的参数）的拥有者更改为 joe：

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

把过程 insert_data（具有两个 integer 类型的参数）的模式更改为 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