Skip to content

Latest commit

 

History

History
117 lines (89 loc) · 4.55 KB

File metadata and controls

117 lines (89 loc) · 4.55 KB
title DROP PROCEDURE (Transact-SQL) | Microsoft Docs
ms.custom
SQL2016_New_Updated
ms.date 10/28/2015
ms.prod sql-non-specified
ms.reviewer
ms.suite
ms.technology
database-engine
ms.tgt_pltfrm
ms.topic language-reference
f1_keywords
DROP PROCEDURE
DROP_PROCEDURE_TSQL
dev_langs
TSQL
helpviewer_keywords
removing stored procedures
dropping procedure groups
deleting stored procedures
deleting procedure groups
DROP PROCEDURE statement
dropping stored procedures
stored procedures [SQL Server], removing
removing procedure groups
ms.assetid 1c2d7235-7b9b-4336-8f17-429e7d82c2c3
caps.latest.revision 51
author BYHAM
ms.author rickbyh
manager jhubbard

DROP PROCEDURE (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-all_md]

Removes one or more stored procedures or procedure groups from the current database in [!INCLUDEssCurrent].

Topic link icon Transact-SQL Syntax Conventions

Syntax

-- Syntax for SQL Server and Azure SQL Database  
  
DROP { PROC | PROCEDURE } [ IF EXISTS ] { [ schema_name. ] procedure } [ ,...n ]  
-- Syntax for Azure SQL Data Warehouse and Parallel Data Warehouse  
  
DROP { PROC | PROCEDURE } { [ schema_name. ] procedure_name }  

Arguments

IF EXISTS

Applies to: [!INCLUDEssNoVersion] ([!INCLUDEssSQL15] through current version).

Conditionally drops the procedure only if it already exists.

schema_name
The name of the schema to which the procedure belongs. A server name or database name cannot be specified.

procedure
The name of the stored procedure or stored procedure group to be removed. Individual procedures within a numbered procedure group cannot be dropped; the whole procedure group is dropped.

Best Practices

Before removing any stored procedure, check for dependent objects and modify these objects accordingly. Dropping a stored procedure can cause dependent objects and scripts to fail when these objects are not updated. For more information, see View the Dependencies of a Stored Procedure

Metadata

To display a list of existing procedures, query the sys.objects catalog view. To display the procedure definition, query the sys.sql_modules catalog view.

Security

Permissions

Requires CONTROL permission on the procedure, or ALTER permission on the schema to which the procedure belongs, or membership in the db_ddladmin fixed server role.

Examples

The following example removes the dbo.uspMyProc stored procedure in the current database.

DROP PROCEDURE dbo.uspMyProc;  
GO  

The following example removes several stored procedures in the current database.

DROP PROCEDURE dbo.uspGetSalesbyMonth, dbo.uspUpdateSalesQuotes, dbo.uspGetSalesByYear;  

The following example removes the dbo.uspMyProc stored procedure if it exists but does not cause an error if the procedure does not exist. This syntax is new in [!INCLUDEssSQL15].

DROP PROCEDURE IF EXISTS dbo.uspMyProc;  
GO  

Examples: [!INCLUDEssSDWfull] and [!INCLUDEssPDW]

The following example removes the dbo.uspMyProc stored procedure in the current database.

DROP PROCEDURE dbo.uspMyProc;  
GO  

See Also

ALTER PROCEDURE (Transact-SQL)
CREATE PROCEDURE (Transact-SQL)
sys.objects (Transact-SQL)
sys.sql_modules (Transact-SQL)
Delete a Stored Procedure