SQL COMMAND · 函数与过程

ALTER AGGREGATE

更改一个聚合函数的定义

change the definition of an aggregate function

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

动词: ALTER
对象: AGGREGATE
分组: 函数与过程
引入版本: 7.4
状态: 现存
语法变更次数: 7
手册小节数: 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 19← 18正文更新

正文更新
PostgreSQL 16← 15正文更新

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

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

+ OWNER TO { new_owner | CURRENT_USER | SESSION_USER }
PostgreSQL 9.4← 9.3语法变化

+ ALTER AGGREGATE name ( aggregate_signature ) RENAME TO new_name+ ALTER AGGREGATE name ( aggregate_signature ) OWNER TO new_owner+ ALTER AGGREGATE name ( aggregate_signature ) SET SCHEMA new_schema+ * |+ [ argmode ] [ argname ] argtype [ , ... ] |+ [ [ argmode ] [ argname ] argtype [ , ... ] ] ORDER BY [ argmode ] [ argname ] argtype [ , ... ]− ALTER AGGREGATE name ( argtype [ , ... ] ) RENAME TO new_name− ALTER AGGREGATE name ( argtype [ , ... ] ) OWNER TO new_owner− ALTER AGGREGATE name ( argtype [ , ... ] ) SET SCHEMA new_schema正文更新
PostgreSQL 9.2← 9.1语法变化

+ ALTER AGGREGATE name ( argtype [ , ... ] ) RENAME TO new_name+ ALTER AGGREGATE name ( argtype [ , ... ] ) OWNER TO new_owner+ ALTER AGGREGATE name ( argtype [ , ... ] ) SET SCHEMA new_schema− ALTER AGGREGATE name ( type [ , ... ] ) RENAME TO new_name− ALTER AGGREGATE name ( type [ , ... ] ) OWNER TO new_owner− ALTER AGGREGATE name ( type [ , ... ] ) SET SCHEMA new_schema正文更新
PostgreSQL 8.2← 8.1语法变化

+ ALTER AGGREGATE name ( type [ , ... ] ) RENAME TO new_name+ ALTER AGGREGATE name ( type [ , ... ] ) OWNER TO new_owner+ ALTER AGGREGATE name ( type [ , ... ] ) SET SCHEMA new_schema正文更新
PostgreSQL 8.1← 8.0语法变化

+ ALTER AGGREGATE name ( type ) RENAME TO new_name+ ALTER AGGREGATE name ( type ) OWNER TO new_owner+ ALTER AGGREGATE name ( type ) SET SCHEMA new_schema− ALTER AGGREGATE name ( type ) RENAME TO newname− ALTER AGGREGATE name ( type ) OWNER TO newowner正文更新
PostgreSQL 8.0← 7.4语法变化

+ ALTER AGGREGATE name ( type ) OWNER TO newowner正文更新
PostgreSQL 7.4← 7.3新增此命令

同组命令

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

语法概要

描述

参数

注解

示例

兼容性

另见

语法演化

相关命令

同组命令