2024 年 9 月 26 日： PostgreSQL 17 发布！
支持的版本：当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本：devel
不支持的版本：11
ALTER PROCEDURE
上一页  向上 SQL 命令 首页  下一页

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

参数的模式：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 中是可选的。

上一页  向上  下一页
ALTER POLICY  首页  ALTER PUBLICATION

提交更正

如果您在文档中发现任何不正确的内容、与您对特定功能的体验不符或需要进一步澄清，请使用 此表格 报告文档问题。