DROP FUNCTION (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Point de terminaison analytique SQL dans Microsoft FabricEntrepôt dans Microsoft Fabric

Supprime une ou plusieurs fonctions définies par l'utilisateur de la base de données active. Les fonctions définies par l’utilisateur sont créées à l’aide de l’instruction CREATE FUNCTION et modifiées à l’aide de l’instruction ALTER FUNCTION.

La fonction DROP prend en charge les fonctions définies par l’utilisateur scalaires compilées en mode natif. Pour plus d’informations, consultez Fonctions scalaires définies par l’utilisateur pour l’OLTP en mémoire.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

IF EXISTS
Supprime, de manière conditionnelle, la fonction uniquement si elle existe déjà. Disponible à partir de SQL Server 2016 et dans SQL Database.

schema_name
Nom du schéma auquel appartient la fonction définie par l'utilisateur.

function_name
Nom de la fonction ou des fonctions définies par l'utilisateur à supprimer. La spécification du nom de schéma est facultative. Il n'est pas possible de spécifier le nom du serveur et de la base de données.

Notes

DROP FUNCTION échoue si la base de données contient des fonctions Transact-SQL ou des vues qui font référence à cette fonction et qui ont été créées au moyen de SCHEMABINDING. Elle échoue également s'il existe des colonnes calculées, des contraintes CHECK ou DEFAULT qui font référence à cette fonction.

DROP FUNCTION échoue si des colonnes calculées qui ont été indexées font référence à cette fonction.

Autorisations

Pour exécuter DROP FUNCTION, un utilisateur doit avoir au minimum l'autorisation ALTER sur le schéma auquel appartient la fonction ou l'autorisation CONTROL sur la fonction.

Exemples

R. Suppression d'une fonction

L’exemple suivant supprime la fonction définie par l’utilisateur fn_SalesByStore du schéma Sales de l’échantillon de base de données AdventureWorks2022. Pour créer cette fonction, consultez l’exemple B dans CREATE FUNCTION (Transact-SQL).

DROP FUNCTION Sales.fn_SalesByStore;

Voir aussi

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