2024年11月21日: PostgreSQL 17.2、16.6、15.10、14.15、13.18 和 12.22 发布！
支持的版本：当前 (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，则不再依赖于扩展。标记为依赖于扩展的存储过程在删除扩展时会被删除，即使未指定 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

提交更正

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