DROP PROCEDURE (Transact-SQL)

  • Article

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

Contenu connexe