SQL COMMAND · 函数与过程

ALTER 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 }+ 其中 action 是以下之一：− OWNER TO { new_owner | CURRENT_USER | SESSION_USER }− 其中action为以下之一：
PostgreSQL 13← 12语法变化

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

同组命令

命令	动词	对象	最近变更
FUNCTIONS & PROCEDURES函数与过程18 条↑
`CALL`	CALL	—	—
调用一个过程			现存
`DO`	DO	—	—
执行匿名代码块			现存
`CREATE AGGREGATE`	CREATE	AGGREGATE	203 次
定义一个新的聚合函数			现存
`ALTER AGGREGATE`	ALTER	AGGREGATE	141 次
更改一个聚合函数的定义			现存
`DROP AGGREGATE`	DROP	AGGREGATE	—
移除一个聚合函数			现存
`CREATE FUNCTION`	CREATE	FUNCTION	143 次
定义一个新函数			现存
`ALTER FUNCTION`	ALTER	FUNCTION	143 次
更改函数的定义			现存
`DROP FUNCTION`	DROP	FUNCTION	—
移除一个函数			现存
`CREATE LANGUAGE`	CREATE	LANGUAGE	131 次
定义一种新的过程语言			现存
`ALTER LANGUAGE`	ALTER	LANGUAGE	141 次
更改一种过程语言的定义			现存
`DROP LANGUAGE`	DROP	LANGUAGE	—
移除一种过程语言			现存
`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	—
定义一个新的转换			现存
`DROP TRANSFORM`	DROP	TRANSFORM	—
移除一个转换			现存

快速链接

版本轨迹

语法铁道图 PostgreSQL 18

语法概要

描述

示例

兼容性

另见

语法演化

相关命令

同组命令