Outdated Version

You are viewing an older version of this section. View current production version.

DROP AGGREGATE

Removes a single user-defined aggregate function (UDAF) from the specified database.

Syntax

DROP AGGREGATE [IF EXISTS] { function_name | database_name.function_name }

Remarks

Only one function can be removed using the DROP AGGREGATE command.

If DROP AGGREGATE is executed for a function that does not exist, the following error will occur:

DROP AGGREGATE myaggregate;
ERROR 2219 (HY000): Function 'db1.myaggregate' doesn't exist

However, if the IF EXISTS clause is used and the function does not exist, no error will occur:

DROP AGGREGATE IF EXISTS myaggregate;
Query OK, 0 rows affected (0.00 sec)

Examples

Dropping a Function in the Current Database

The following example removes an existing function from the current database.

SHOW AGGREGATES;
+-------------------+
| Aggregates_in_db1 |
+-------------------+
| multiply_hundred  |
| myaggregate       |
+-------------------+
2 rows in set (0.00 sec)

DROP AGGREGATE myaggregate;
Query OK, 0 rows affected (0.05 sec)

SHOW AGGREGATES;
+-------------------+
| Aggregates_in_db1 |
+-------------------+
| multiply_hundred  |
+-------------------+
1 row in set (0.00 sec)

Dropping a Function in Another Database

The following example removes an existing function while connected to another database in your cluster.

USE db1;

Database changed

SHOW AGGREGATES;
+-------------------+
| Aggregates_in_db1 |
+-------------------+
| multiply_hundred  |
| myaggregate       |
+-------------------+
2 rows in set (0.00 sec)

USE db2;

Database changed

DROP AGGREGATE db1.myaggregate;
Query OK, 0 rows affected (0.05 sec)

USE db1;

Database changed

SHOW AGGREGATES;
+-------------------+
| Aggregates_in_db1 |
+-------------------+
| multiply_hundred  |
+-------------------+
1 row in set (0.00 sec)