---
title: "DROP AGGREGATE"
id: sql-dropaggregate
pg_version: "20devel"
---

<a id="sql-dropaggregate"></a>

# DROP AGGREGATE — remove an aggregate function

## Synopsis

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

where aggregate_signature is:

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

<a id="id-1.9.3.106.5"></a>

## Description

`DROP AGGREGATE` removes an existing aggregate function. To execute this command the current user must be the owner of the aggregate function. 

<a id="id-1.9.3.106.6"></a>

## Parameters

**`IF EXISTS`**

 Do not throw an error if the aggregate does not exist. A notice is issued in this case. **`name`**

 The name (optionally schema-qualified) of an existing aggregate function. **`argmode`**

 The mode of an argument: `IN` or `VARIADIC`. If omitted, the default is `IN`. **`argname`**

 The name of an argument. Note that `DROP AGGREGATE` does not actually pay any attention to argument names, since only the argument data types are needed to determine the aggregate function's identity. **`argtype`**

 An input data type on which the aggregate function operates. To reference a zero-argument aggregate function, write `*` in place of the list of argument specifications. To reference an ordered-set aggregate function, write `ORDER BY` between the direct and aggregated argument specifications. **`CASCADE`**

 Automatically drop objects that depend on the aggregate function (such as views using it), and in turn all objects that depend on those objects (see [Section 5.17](ddl-depend.md)). **`RESTRICT`**

 Refuse to drop the aggregate function if any objects depend on it. This is the default. <a id="id-1.9.3.106.7"></a>

## Notes

Alternative syntaxes for referencing ordered-set aggregates are described under [ALTER AGGREGATE](sql-alteraggregate.md). 

<a id="id-1.9.3.106.8"></a>

## Examples

To remove the aggregate function `myavg` for type `integer`: 
DROP AGGREGATE myavg(integer);
 

To remove the hypothetical-set aggregate function `myrank`, which takes an arbitrary list of ordering columns and a matching list of direct arguments: 
DROP AGGREGATE myrank(VARIADIC "any" ORDER BY VARIADIC "any");
 

To remove multiple aggregate functions in one command: 
DROP AGGREGATE myavg(integer), myavg(bigint);


<a id="id-1.9.3.106.9"></a>

## Compatibility

There is no `DROP AGGREGATE` statement in the SQL standard. 

<a id="id-1.9.3.106.10"></a>

## See Also

[ALTER AGGREGATE](sql-alteraggregate.md), [CREATE AGGREGATE](sql-createaggregate.md)