DROP FUNCTION (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)Ponto de extremidade de SQL no Microsoft FabricWarehouse no Microsoft Fabric

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 com CREATE FUNCTION e modificadas com ALTER FUNCTION.

A função DROP dá suporte a funções escalares definidas pelo usuário compiladas nativamente. Para obter mais informações, consulte Funções escalares definidas pelo usuário para OLTP in-memory.

Convenções de sintaxe de Transact-SQL

Sintaxe

 -- SQL Server, Azure SQL Database 

DROP FUNCTION [ IF EXISTS ] { [ schema_name. ] function_name } [ ,...n ]   
[;]

 -- Azure Synapse Analytics, Parallel Data Warehouse, Microsoft Fabric

DROP FUNCTION [IF EXISTS] [ schema_name. ] function_name
[;] 

Observação

Para ver a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

IF EXISTS
Remove condicionalmente a função somente se ela já existe. Disponível a partir do SQL Server 2016 e no Banco de Dados SQL.

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

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 remove a função definida pelo usuário fn_SalesByStore do esquema Sales no banco de dados de exemplo AdventureWorks2022. Para criar essa função, confira o exemplo B em CREATE FUNCTION (Transact-SQL).

DROP FUNCTION Sales.fn_SalesByStore;  

Consulte Também

ALTER FUNCTION (Transact-SQL)
CREATE FUNCTION (Transact-SQL)
OBJECT_ID (Transact-SQL)
EVENTDATA (Transact-SQL)
sys.sql_modules (Transact-SQL)
sys.parameters (Transact-SQL)