FUNÇÃO DE QUEDA (Transact-SQL)

Aplica-se a:SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Ponto de Extremidade de Análise SQL no Microsoft FabricArmazém no Microsoft FabricBase de Dados SQL no Microsoft Fabric

Remove uma ou mais funções definidas pelo utilizador da base de dados atual. As funções definidas pelo utilizador são criadas usando CREATE FUNCTION e modificadas usando ALTER FUNCTION.

A função DROP suporta funções definidas pelo utilizador e escalares compiladas nativamente. Para obter mais informações, consulte Funções User-Defined escalares para In-Memory OLTP.

Transact-SQL convenções de sintaxe

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
[;] 

Arguments

SE EXISTE
A função só se ela já existir é que é descartada condicionalmente. Disponível a partir do SQL Server 2016 e na Base de Dados SQL.

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

function_name
É o nome da função ou funções definidas pelo utilizador a serem removidas. Especificar o nome do esquema é opcional. O nome do servidor e da base de dados não podem ser especificados.

Observações

DROP FUNCTION falhará se existirem Transact-SQL funções ou vistas na base de dados que referenciam esta função e tenham sido criadas usando SCHEMABINDING, ou se existirem colunas computadas, restrições CHECK ou restrições DEFAULT que referenciam a função.

DROP FUNCTION falhará se existirem colunas computadas que referenciam esta função e tiverem sido indexadas.

Permissions

Para executar a DROP FUNCTION, no mínimo, o utilizador deve ter permissão ALTER sobre o esquema a que a função pertence, ou permissão CONTROL sobre a função.

Examples

A. Eliminar uma função

O exemplo seguinte elimina a fn_SalesByStore função definida pelo utilizador do Sales esquema na base de dados de exemplo AdventureWorks2025. Para criar esta função, veja o Exemplo B em CRIAR FUNÇÃO (Transact-SQL).

DROP FUNCTION Sales.fn_SalesByStore;  

Ver também

ALTERAR FUNÇÃO (Transact-SQL)
CRIAR FUNÇÃO (Transact-SQL)
OBJECT_ID (Transact-SQL)
EVENTDATA (Transact-SQL)
sys.sql_módulos (Transact-SQL)
sys.parameters (Transact-SQL)