DROP PROCEDURE (Transact-SQL)
S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL analytics endpoint in Microsoft Fabric Warehouse in Microsoft Fabric
Supprime une ou plusieurs procédures stockées ou un ou plusieurs groupes de procédures de la base de données active dans SQL Server.
Conventions de la syntaxe Transact-SQL
Syntaxe
Syntaxe pour SQL Server, Azure SQL Managed Instance et Azure SQL Database :
DROP { PROC | PROCEDURE } [ IF EXISTS ] { [ schema_name. ] procedure } [ , ...n ]
Syntaxe suivante pour Azure Synapse Analytics, Analytics Platform System (PDW) et Microsoft Fabric :
DROP { PROC | PROCEDURE } { [ schema_name. ] procedure_name }
Arguments
IF EXISTS
S’applique à : SQL Server 2016 (13.x) et versions ultérieures, Azure SQL Managed Instance et Azure SQL Database
Supprime, de manière conditionnelle, la procédure uniquement si elle existe déjà.
schema_name
Nom du schéma auquel appartient la procédure. Un nom de serveur ou un nom de base de données ne peut pas être spécifié.
procedure
Nom de la procédure stockée ou du groupe de procédures stockées à supprimer. Les procédures individuelles au sein d’un groupe de procédures numérotées ne peuvent pas être supprimées ; l’ensemble du groupe de procédures est supprimé.
Bonnes pratiques
Avant de supprimer une procédure stockée, vérifiez les objets dépendants et modifiez-les en conséquence. La suppression d’une procédure stockée peut entraîner l’échec des objets dépendants et des scripts lorsque ces objets ne sont pas mis à jour. Pour plus d’informations, consultez Afficher les dépendances d’une procédure stockée.
Métadonnées
Pour afficher la liste des procédures existantes, interrogez l’affichage sys.objects
catalogue. Pour afficher la définition de procédure, interrogez l’affichage sys.sql_modules
catalogue.
autorisations
Nécessite CONTROL
l’autorisation sur la procédure, ou ALTER
l’autorisation sur le schéma auquel appartient la procédure, ou l’appartenance au rôle serveur fixe db_ddladmin .
Exemples
L'exemple suivant supprime la procédure stockée dbo.uspMyProc
de la base de données active.
DROP PROCEDURE dbo.uspMyProc;
GO
L'exemple suivant supprime plusieurs procédures stockées de la base de données active.
DROP PROCEDURE
dbo.uspGetSalesbyMonth,
dbo.uspUpdateSalesQuotes,
dbo.uspGetSalesByYear;
L’exemple suivant supprime la dbo.uspMyProc
procédure stockée s’il existe, mais n’entraîne pas d’erreur si la procédure n’existe pas. Cette syntaxe a été introduite dans SQL Server 2016 (13.x).
DROP PROCEDURE IF EXISTS dbo.uspMyProc;
GO