↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

Wiki / SQL 命令

ALTER PROCEDURE

更改过程的定义

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

11121314151617181920
anchor
SQL-ALTERPROCEDURE
file
sql-alterprocedure.html
lang
en
name
ALTER PROCEDURE
purpose
change the definition of a procedure
purpose zh
未知
sections same as
未知
slug
18

语法

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 name ( argmode argname argtype , ) action RESTRICT
ALTER PROCEDURE · 语法 2
ALTER PROCEDURE name ( argmode argname argtype , ) RENAME TO new_name
ALTER PROCEDURE · 语法 3
ALTER PROCEDURE name ( argmode argname argtype , ) OWNER TO new_owner CURRENT_ROLE CURRENT_USER SESSION_USER
ALTER PROCEDURE · 语法 4
ALTER PROCEDURE name ( argmode argname argtype , ) SET SCHEMA new_schema
ALTER PROCEDURE · 语法 5
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

版本定义 PG 18

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权限。要更改拥有者，你必须能够对新的拥有角色执行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，则表示不再依赖该扩展。被标记为依赖扩展的过程会在扩展被删除时一并删除，即使没有指定 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和第 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 PROCEDURE, DROP PROCEDURE, ALTER FUNCTION, ALTER ROUTINE

比较版本

完整来源事实

synopsis html

ALTER PROCEDURE <em class="replaceable"><code>name</code></em> [ ( [ [ <em class="replaceable"><code>argmode</code></em> ] [ <em class="replaceable"><code>argname</code></em> ] <em class="replaceable"><code>argtype</code></em> [, ...] ] ) ]
    <em class="replaceable"><code>action</code></em> [ ... ] [ RESTRICT ]
ALTER PROCEDURE <em class="replaceable"><code>name</code></em> [ ( [ [ <em class="replaceable"><code>argmode</code></em> ] [ <em class="replaceable"><code>argname</code></em> ] <em class="replaceable"><code>argtype</code></em> [, ...] ] ) ]
    RENAME TO <em class="replaceable"><code>new_name</code></em>
ALTER PROCEDURE <em class="replaceable"><code>name</code></em> [ ( [ [ <em class="replaceable"><code>argmode</code></em> ] [ <em class="replaceable"><code>argname</code></em> ] <em class="replaceable"><code>argtype</code></em> [, ...] ] ) ]
    OWNER TO { <em class="replaceable"><code>new_owner</code></em> | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER PROCEDURE <em class="replaceable"><code>name</code></em> [ ( [ [ <em class="replaceable"><code>argmode</code></em> ] [ <em class="replaceable"><code>argname</code></em> ] <em class="replaceable"><code>argtype</code></em> [, ...] ] ) ]
    SET SCHEMA <em class="replaceable"><code>new_schema</code></em>
ALTER PROCEDURE <em class="replaceable"><code>name</code></em> [ ( [ [ <em class="replaceable"><code>argmode</code></em> ] [ <em class="replaceable"><code>argname</code></em> ] <em class="replaceable"><code>argtype</code></em> [, ...] ] ) ]
    [ NO ] DEPENDS ON EXTENSION <em class="replaceable"><code>extension_name</code></em>

<span class="phrase">where <em class="replaceable"><code>action</code></em> is one of:</span>

    [ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER
    SET <em class="replaceable"><code>configuration_parameter</code></em> { TO | = } { <em class="replaceable"><code>value</code></em> | DEFAULT }
    SET <em class="replaceable"><code>configuration_parameter</code></em> FROM CURRENT
    RESET <em class="replaceable"><code>configuration_parameter</code></em>
    RESET ALL

synopsis text

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

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c