Redrock Postgres 搜索 英文
版本: 11 / 12 / 13 / 14 / 15 / 16 / 17

ALTER PROCEDURE

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

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

参数的模式:INOUTINOUTVARIADIC。如果省略,默认为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

在调用该过程时,添加或更改要对配置参数进行的分配。如果 valueDEFAULT,或者等效地使用 RESET,那么过程本地设置将被删除,从而使该过程使用其环境中存在的 value 执行。使用 RESET ALL 清除所有过程本地设置。当执行 ALTER PROCEDURE 时,SET FROM CURRENT 将该参数的当前值保存为进入该过程时要应用的值。

请参阅 SET第 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 中这是可选的。

另请参阅

CREATE PROCEDUREDROP PROCEDUREALTER FUNCTIONALTER ROUTINE