DROP AGGREGATE

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 [ , ... ]

Description

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

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 attention to argument names, since only the argument data types are needed to determine the aggregate function's identity.

argtype

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

CASCADE

Automatically drop objects that depend on the aggregate function (such as views using it), and in turn drop all objects that depend on those objects.

RESTRICT

Refuse to drop the aggregate function if any objects depend on it. This is the default.

Notes

An alternative syntax for referencing ordered-set aggregates is described under ALTER AGGREGATE.

Examples

# To remove the aggregate function myavg for type integer:

DROP AGGREGATE myavg(integer);

# To remove the hypothetical-set aggregate function myrank, which accepts an arbitrary list of sorting columns and a matching list of direct arguments:

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

# To drop multiple aggregate functions in a single command:

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

See Also

ALTER AGGREGATE, CREATE AGGREGATE