2025年9月25日: PostgreSQL 18 发布！
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 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 时不再依赖于扩展。被标记为依赖于扩展的存储过程在扩展被删除时将被删除，即使没有指定级联。一个存储过程可以依赖于多个扩展，并在任何一个扩展被删除时被删除。

[ 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;

将具有两个 integer 类型参数的存储过程 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

提交更正

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