| description | DROP AGGREGATE (Transact-SQL) | ||||||
|---|---|---|---|---|---|---|---|
| title | DROP AGGREGATE (Transact-SQL) | Microsoft Docs | ||||||
| ms.custom | |||||||
| ms.date | 05/10/2017 | ||||||
| ms.prod | sql | ||||||
| ms.prod_service | sql-database | ||||||
| ms.reviewer | |||||||
| ms.technology | t-sql | ||||||
| ms.topic | reference | ||||||
| f1_keywords |
|
||||||
| dev_langs |
|
||||||
| helpviewer_keywords |
|
||||||
| ms.assetid | 84ffc4e7-c451-4f1f-9a67-7fc3a120e53f | ||||||
| author | WilliamDAssafMSFT | ||||||
| ms.author | wiassaf |
[!INCLUDE SQL Server]
Removes a user-defined aggregate function from the current database. User-defined aggregate functions are created by using CREATE AGGREGATE.
Transact-SQL Syntax Conventions
DROP AGGREGATE [ IF EXISTS ] [ schema_name . ] aggregate_name
[!INCLUDEsql-server-tsql-previous-offline-documentation]
IF EXISTS
Applies to: [!INCLUDEssNoVersion] ( [!INCLUDEsssql16-md] through current version).
Conditionally drops the aggregate only if it already exists.
schema_name
Is the name of the schema to which the user-defined aggregate function belongs.
aggregate_name
Is the name of the user-defined aggregate function you want to drop.
DROP AGGREGATE does not execute if there are any views, functions, or stored procedures created with schema binding that reference the user-defined aggregate function you want to drop.
To execute DROP AGGREGATE, at a minimum, a user must have ALTER permission on the schema to which the user-defined aggregate belongs, or CONTROL permission on the aggregate.
The following example drops the aggregate Concatenate.
DROP AGGREGATE dbo.Concatenate; CREATE AGGREGATE (Transact-SQL)
Create User-defined Aggregates