SQL COMMAND · 函数与过程

ALTER AGGREGATE

更改一个聚合函数的定义

ALTER函数与过程引入 10（基线）现存至 20 devel1 次语法变更

动词: ALTER
对象: AGGREGATE
分组: 函数与过程
引入版本: 10（基线）
状态: 现存
语法变更次数: 1
手册小节数: 6

本站手册 · 18 官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

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

ALTER AGGREGATE · 语法 2

ALTER AGGREGATE · 语法 3

aggregate_signature

语法概要

ALTER AGGREGATE name ( aggregate_signature ) RENAME TO new_name
ALTER AGGREGATE name ( aggregate_signature )
                OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER AGGREGATE name ( aggregate_signature ) SET SCHEMA new_schema
其中 aggregate_signature 是：

* |
[ argmode ] [ argname ] argtype [ , ... ] |
[ [ argmode ] [ argname ] argtype [ , ... ] ] ORDER BY [ argmode ] [ argname ] argtype [ , ... ]

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

描述

ALTER AGGREGATE更改聚合函数的定义。

要使用ALTER AGGREGATE，你必须拥有该聚合函数。要更改聚合函数的模式，你还必须在新模式上具有 CREATE权限。要更改拥有者，你必须能够对新的拥有角色执行 SET ROLE，并且该角色必须在该聚合函数所在模式上具有 CREATE权限。（这些限制确保更改拥有者不会做出任何你无法通过删除并重新创建该聚合函数来完成的事情。不过，超级用户无论如何都可以更改任何聚合函数的所有权。）

参数

name: 现有聚合函数的名称（可以用模式限定）。
argmode: 参数的模式：IN或VARIADIC。如果省略，默认为IN。
argname: 参数的名称。注意，ALTER AGGREGATE 实际上并不关心参数名，因为确定聚合函数的标识只需要参数的数据类型。
argtype: 聚合函数作用于其上的输入数据类型。要引用零参数聚合函数，请在参数说明列表的位置写上*。要引用有序集聚合函数，请在直接参数说明和聚合参数说明之间写上ORDER BY。
new_name: 聚合函数的新名称。
new_owner: 聚合函数的新拥有者。
new_schema: 聚合函数的新模式。

注解

引用有序集聚合的推荐语法，是像CREATE AGGREGATE 中那样，在直接参数说明和聚合参数说明之间写上ORDER BY。不过，省略ORDER BY，直接把两部分参数说明合并为一个列表也同样可行。在这种简写形式中，如果直接参数列表和聚合参数列表中都使用了VARIADIC "any"，则只需写一次VARIADIC "any"。

示例

要把用于类型integer的聚合函数 myavg重命名为my_average：

ALTER AGGREGATE myavg(integer) RENAME TO my_average;

要把用于类型integer的聚合函数 myavg的拥有者改为joe：

ALTER AGGREGATE myavg(integer) OWNER TO joe;

把直接参数类型为float8、聚合参数类型为integer 的有序集聚合mypercentile移动到模式myschema中：

ALTER AGGREGATE mypercentile(float8 ORDER BY integer) SET SCHEMA myschema;

这也同样可行：

ALTER AGGREGATE mypercentile(float8, integer) SET SCHEMA myschema;

兼容性

在 SQL 标准中没有ALTER AGGREGATE语句。

另见

CREATE AGGREGATE, DROP AGGREGATE

语法演化

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

PostgreSQL 20← 19正文更新

正文更新
PostgreSQL 14← 13语法变化

+ OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }+ 其中 aggregate_signature 是：− OWNER TO { new_owner | CURRENT_USER | SESSION_USER }− 其中aggregate_signature为：正文更新

同组命令

命令	动词	对象	最近变更
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

语法概要

描述

参数

注解

示例

兼容性

另见

语法演化

相关命令

同组命令