ALTER PROCEDURE — 更改过程定义
ALTER PROCEDUREname
[ ( [ [argmode
] [argname
]argtype
[, ...] ] ) ]action
[ ... ] [ RESTRICT ] ALTER PROCEDUREname
[ ( [ [argmode
] [argname
]argtype
[, ...] ] ) ] RENAME TOnew_name
ALTER PROCEDUREname
[ ( [ [argmode
] [argname
]argtype
[, ...] ] ) ] OWNER TO {new_owner
| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER PROCEDUREname
[ ( [ [argmode
] [argname
]argtype
[, ...] ] ) ] SET SCHEMAnew_schema
ALTER PROCEDUREname
[ ( [ [argmode
] [argname
]argtype
[, ...] ] ) ] [ NO ] DEPENDS ON EXTENSIONextension_name
whereaction
is one of: [ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER SETconfiguration_parameter
{ TO | = } {value
| DEFAULT } SETconfiguration_parameter
FROM CURRENT RESETconfiguration_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
,那么过程本地设置将被删除,从而使该过程使用其环境中存在的 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 中这是可选的。