SQL COMMAND · 函数与过程

ALTER ROUTINE

更改一个例程的定义

change the definition of a routine

ALTER函数与过程引入 11现存至 20 devel2 次语法变更

动词: ALTER
对象: ROUTINE
分组: 函数与过程
引入版本: 11
状态: 现存
语法变更次数: 2
手册小节数: 4

本站手册 · 18 官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读，分岔表示选择，绕行表示可选，回环表示重复。方框为参数，点击带下划线的参数可展开子规则。

ALTER ROUTINE · 语法 2

ALTER ROUTINE · 语法 3

ALTER ROUTINE · 语法 4

ALTER ROUTINE · 语法 5

action

语法概要

ALTER ROUTINE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
action [ ... ] [ RESTRICT ]
ALTER ROUTINE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
RENAME TO new_name
ALTER ROUTINE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER ROUTINE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
SET SCHEMA new_schema
ALTER ROUTINE name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
[ NO ] DEPENDS ON EXTENSION extension_name
其中 action 是以下之一：

IMMUTABLE | STABLE | VOLATILE
[ NOT ] LEAKPROOF
[ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER
PARALLEL { UNSAFE | RESTRICTED | SAFE }
COST execution_cost
ROWS result_rows
SET configuration_parameter { TO | = } { value | DEFAULT }
SET configuration_parameter FROM CURRENT
RESET configuration_parameter
RESET ALL

PostgreSQL 18 手册 · 查看完整参考页

描述

ALTER ROUTINE 更改一个例程的定义。术语“例程”包括聚合函数、普通函数和过程。参数说明、更多示例以及进一步细节，请分别参见 ALTER AGGREGATE、ALTER FUNCTION 和 ALTER PROCEDURE。

示例

将针对 integer 类型的例程 foo 重命名为 foobar：

ALTER ROUTINE foo(integer) RENAME TO foobar;

不管 foo 是聚合、函数还是过程，这条命令都可以工作。

兼容性

该语句与 SQL 标准中的 ALTER ROUTINE 语句部分兼容。更多细节请参见 ALTER FUNCTION 和 ALTER PROCEDURE。允许例程名引用聚合函数是 PostgreSQL 的扩展。

另见

ALTER AGGREGATE, ALTER FUNCTION, ALTER PROCEDURE, DROP ROUTINE

注意，没有 CREATE ROUTINE 命令。

语法演化

相邻大版本之间的差异，新的在前。版本号链接到对应快照。

PostgreSQL 14← 13语法变化

+ OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
PostgreSQL 13← 12语法变化

+ [ NO ] DEPENDS ON EXTENSION extension_name
PostgreSQL 11← 10新增此命令

同组命令

命令	动词	对象	最近变更
FUNCTIONS & PROCEDURES函数与过程18 条↑
`CALL`	CALL	—	—
调用一个过程			现存
`DO`	DO	—	—
执行匿名代码块			现存
`CREATE AGGREGATE`	CREATE	AGGREGATE	1911 次
定义一个新的聚合函数			现存
`ALTER AGGREGATE`	ALTER	AGGREGATE	147 次
更改一个聚合函数的定义			现存
`DROP AGGREGATE`	DROP	AGGREGATE	106 次
移除一个聚合函数			现存
`CREATE FUNCTION`	CREATE	FUNCTION	1416 次
定义一个新函数			现存
`ALTER FUNCTION`	ALTER	FUNCTION	1411 次
更改函数的定义			现存
`DROP FUNCTION`	DROP	FUNCTION	104 次
移除一个函数			现存
`CREATE LANGUAGE`	CREATE	LANGUAGE	137 次
定义一种新的过程语言			现存
`ALTER LANGUAGE`	ALTER	LANGUAGE	144 次
更改一种过程语言的定义			现存
`DROP LANGUAGE`	DROP	LANGUAGE	8.25 次
移除一种过程语言			现存
`CREATE PROCEDURE`	CREATE	PROCEDURE	141 次
定义一个新过程			现存
`ALTER PROCEDURE`	ALTER	PROCEDURE	142 次
更改过程的定义			现存
`DROP PROCEDURE`	DROP	PROCEDURE	—
移除一个过程			现存
`ALTER ROUTINE`	ALTER	ROUTINE	142 次
更改一个例程的定义			现存
`DROP ROUTINE`	DROP	ROUTINE	—
移除一个例程			现存
`CREATE TRANSFORM`	CREATE	TRANSFORM	101 次
定义一个新的转换			现存
`DROP TRANSFORM`	DROP	TRANSFORM	9.61 次
移除一个转换			现存

快速链接

版本轨迹

语法铁道图 PostgreSQL 18

语法概要

描述

示例

兼容性

另见

语法演化

相关命令

同组命令