Share via


DROP FUNCTION (Transact-SQL)

Remove uma ou mais funções definidas pelo usuário do banco de dados atual. As funções definidas pelo usuário são criadas usando CREATE FUNCTION e modificadas usando ALTER FUNCTION.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

DROP FUNCTION { [ schema_name. ] function_name } [ ,...n ] 

Argumentos

  • schema_name
    É o nome do esquema ao qual pertence a função definida pelo usuário.

  • function_name
    É o nome da função ou funções definidas pelo usuário a serem removidas. A especificação do nome de esquema é opcional. Não é possível especificar o nome de servidor e de banco de dados.

Comentários

DROP FUNCTION falhará se houver funções ou exibições Transact-SQL no banco de dados que referenciem essa função e forem criadas usando SCHEMABINDING, ou se houver colunas computadas, restrições CHECK ou DEFAULT que referenciem a função.

DROP FUNCTION falhará se houver colunas computadas que referenciem essa função e tenham sido indexadas.

Permissões

Para executar DROP FUNCTION, no mínimo, um usuário deve ter permissão ALTER no esquema ao qual pertence a função definida pelo usuário ou permissão CONTROL na função.

Exemplos

A. Descartando uma função

O exemplo a seguir descarta a função definida pelo usuário fn_SalesByStore do esquema Sales no banco de dados de exemplo AdventureWorks2008R2. Para criar essa função, consulte o Exemplo B em CREATE FUNCTION (Transact-SQL).

USE AdventureWorks2008R2;
GO
IF OBJECT_ID (N'Sales.fn_SalesByStore', N'IF') IS NOT NULL
    DROP FUNCTION Sales.fn_SalesByStore;
GO