MySQL DROP PROCEDURE
Summary: in this tutorial, you will learn how to use the MySQL DROP PROCEDURE statement to drop a stored procedure.
Introduction to the MySQL DROP PROCEDURE statement
The DROP PROCEDURE statement deletes a stored procedure created by the CREATE PROCEDURE statement.
The following shows the syntax of the DROP PROCEDURE statement:
DROP PROCEDURE [IF EXISTS] stored_procedure_name;Code language: SQL (Structured Query Language) (sql)
In this syntax:
- First, specify the name of the stored procedure that you want to remove after the
DROP PROCEDUREkeywords. - Second, use
IF EXISTSoption to conditionally drop the stored procedure if it exists.
When you drop a procedure that does not exist without using the IF EXISTS option, MySQL issues an error. In this case, if you use the IF EXISTS option, MySQL issues a warning instead.
Note that you need to have the ALTER ROUTINE privilege of the stored procedure in order to remove it.
MySQL DROP PROCEDURE examples
Let’s take some examples of using the DROP PROCEDURE statement.
1) Using MySQL DROP PROCEDURE example
First, create a new stored procedure that returns employee and office information:
DELIMITER $$BEGIN
SELECT
firstName,
lastName,
city,
state,
country
FROM employees
INNER JOIN offices using (officeCode);
Code language: SQL (Structured Query Language) (sql)
Second, use the DROP PROCEDURE to delete the GetEmployees() stored procedure:
DROP PROCEDURE GetEmployees;Code language: SQL (Structured Query Language) (sql)
2) Using MySQL DROP PROCEDURE with the IF EXISTS option example
The following example drops a stored procedure that does not exist:
DROP PROCEDURE abc;Code language: SQL (Structured Query Language) (sql)
MySQL issued the following error:
Error Code: 1305. PROCEDURE classicmodels.abc does not existCode language: SQL (Structured Query Language) (sql)
This statement drops the same non-existing stored procedure, but with IF EXISTS option:
DROP PROCEDURE IF EXISTS abc;Code language: SQL (Structured Query Language) (sql)
This time MySQL issued a warning.
0 row(s) affected, 1 warning(s): 1305 PROCEDURE classicmodels.abc does not existCode language: SQL (Structured Query Language) (sql)
The statement SHOW WARNINGS shows the warning:
SHOW WARNINGS;Code language: SQL (Structured Query Language) (sql)
Here is the output:
Dropping a stored procedure using MySQL Workbench
This statement creates a new stored procedure named GetPayments() that returns the customer and payment information:
DELIMITER $$BEGIN
SELECT
customerName,
checkNumber,
paymentDate,
amount
FROM payments
INNER JOIN customers
using (customerNumber);
END$$
Code language: SQL (Structured Query Language) (sql)
To drop the stored procedure using MySQL Workbench, you follow these steps:
First, right-click the name of the stored procedure that you want to remove and choose Drop Stored Procedure… option.
MySQL Workbench will display a confirmation window.
Second, click Review SQL to review the SQL statement that MySQL Workbench will apply to the database, or click the Drop Now if you want to immediately remove the stored procedure.
Third, review the SQL code and click the Execute button to drop the stored procedure.
Summary
- Use
DROP PROCEDUREstatement to remove a stored procedure. - Use
IF EXISTSoption to drop the stored procedure if it exists.