DROP AGGREGATE

移除一个聚合函数

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

6.4 6.5 7.0 7.1 7.2 7.3 7.4 8.0 8.1 8.2 8.3 8.4 9.0 9.1 9.2 9.3 9.4 9.5 9.6 10 11 12 13 14 15 16 17 18 19 20

anchor: SQL-DROPAGGREGATE
file: sql-dropaggregate.html
lang: en
name: DROP AGGREGATE
purpose: remove an aggregate function
purpose zh: 未知
sections same as: 未知
slug: 18

语法

DROP AGGREGATE [ IF EXISTS ] name ( aggregate_signature ) [, ...] [ CASCADE | RESTRICT ]

where aggregate_signature is:

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

语法图

从左向右阅读；分支表示选择，旁路表示可选，循环表示重复。点击带下划线的参数可打开对应规则。

aggregate_signature

版本定义 PG 18

DROP AGGREGATE [ IF EXISTS ] name ( aggregate_signature ) [, ...] [ CASCADE | RESTRICT ]

其中 aggregate_signature 是：

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

描述

DROP AGGREGATE移除一个现有聚合函数。要执行此命令，当前用户必须是该聚合函数的拥有者。

参数

IF EXISTS: 如果该聚合函数不存在，则不要抛出错误。这种情况下会发出一个提示。
name: 现有聚合函数的名称（可以用模式限定）。
argmode: 参数的模式：IN或VARIADIC。如果省略，默认为IN。
argname: 一个参数的名称。注意，DROP AGGREGATE 实际上不会关注参数名，因为确定聚合函数标识所需的只有参数数据类型。
argtype: 聚合函数作用于其上的输入数据类型。要引用零参数聚合函数，请在参数说明列表的位置写上*。要引用有序集聚合函数，请在直接参数说明和聚合参数说明之间写上ORDER BY。
CASCADE: 自动删除依赖于该聚合函数的对象（例如使用它的视图），以及进一步依赖于这些对象的所有对象（参见第 5.15 节）。
RESTRICT: 如果有任何对象依赖于该聚合函数，则拒绝删除它。这是默认值。

注解

关于引用有序集聚合的其他语法，参见ALTER AGGREGATE。

示例

要移除用于类型integer的聚合函数myavg：

DROP AGGREGATE myavg(integer);

要移除假想集聚合函数myrank，它接受任意个排序列组成的列表以及与之匹配的直接参数列表：

DROP AGGREGATE myrank(VARIADIC "any" ORDER BY VARIADIC "any");

在一条命令中移除多个聚合函数：

DROP AGGREGATE myavg(integer), myavg(bigint);

兼容性

SQL 标准中没有DROP AGGREGATE语句。

另见

ALTER AGGREGATE, CREATE AGGREGATE

比较版本

完整来源事实

synopsis html

DROP AGGREGATE [ IF EXISTS ] <em class="replaceable"><code>name</code></em> ( <em class="replaceable"><code>aggregate_signature</code></em> ) [, ...] [ CASCADE | RESTRICT ]

<span class="phrase">where <em class="replaceable"><code>aggregate_signature</code></em> is:</span>

* |
[ <em class="replaceable"><code>argmode</code></em> ] [ <em class="replaceable"><code>argname</code></em> ] <em class="replaceable"><code>argtype</code></em> [ , ... ] |
[ [ <em class="replaceable"><code>argmode</code></em> ] [ <em class="replaceable"><code>argname</code></em> ] <em class="replaceable"><code>argtype</code></em> [ , ... ] ] ORDER BY [ <em class="replaceable"><code>argmode</code></em> ] [ <em class="replaceable"><code>argname</code></em> ] <em class="replaceable"><code>argtype</code></em> [ , ... ]

synopsis text

DROP AGGREGATE [ IF EXISTS ] name ( aggregate_signature ) [, ...] [ CASCADE | RESTRICT ]

where aggregate_signature is:

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

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c