info > DROP_AGGREGATE(7)

man perldoc info pydoc3 ri search

DROP AGGREGATE(7) PostgreSQL 14.23 Documentation DROP AGGREGATE(7)

🏷️ NAME

DROP_AGGREGATE - remove an aggregate function

🚀 Quick Reference

Use Case	Command	Description
🗑️ Remove a simple aggregate	DROP AGGREGATE myavg(integer);	Drop the aggregate function myavg for type integer
🔍 Remove with existence check	DROP AGGREGATE IF EXISTS myavg(integer);	Drop only if exists, no error otherwise
📦 Remove multiple aggregates	DROP AGGREGATE myavg(integer), myavg(bigint);	Drop several aggregate functions in one command
🌊 Cascade drop	DROP AGGREGATE myavg(integer) CASCADE;	Drop aggregate and all dependent objects
🛑 Restrict drop (default)	DROP AGGREGATE myavg(integer) RESTRICT;	Refuse drop if any objects depend on it
🔢 Drop ordered-set aggregate	DROP AGGREGATE myrank(VARIADIC "any" ORDER BY VARIADIC "any");	Drop a hypothetical-set or ordered-set aggregate

📋 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 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.14).

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

💡 NOTES

Alternative syntaxes for referencing ordered-set aggregates are described under ALTER AGGREGATE.

📚 EXAMPLES

To remove the aggregate function myavg for type integer:

DROP AGGREGATE myavg(integer);

✅ Simple drop by aggregate name and input type.

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");

✅ Drop of an ordered-set aggregate with VARIADIC arguments.

To remove multiple aggregate functions in one command:

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

✅ Batch drop of multiple aggregates in a single statement.

🔄 COMPATIBILITY

There is no DROP AGGREGATE statement in the SQL standard.

🔗 SEE ALSO

ALTER AGGREGATE, CREATE AGGREGATE

PostgreSQL 14.23 2026 DROP AGGREGATE(7)

🏷️ NAME 🚀 Quick Reference 📋 SYNOPSIS 📝 DESCRIPTION ⚙️ PARAMETERS 💡 NOTES 📚 EXAMPLES 🔄 COMPATIBILITY 🔗 SEE ALSO