MySQL - SHOW PROCEDURE STATUS Statement

SHOW PROCEDURE STATUS Statement

Stored procedures are sub routines, segment of SQL statements which are stored in SQL catalog. All the applications that can access Relational databases (Java, Python, PHP etc.), can access stored procedures.

Stored procedures contain IN and OUT parameters or both. They may return result sets in case you use SELECT statements. Stored procedures can return multiple result sets.

The MySQL SHOW PROCEDURE STATUS statement displays the features of the stored procedures. It provides information such as −

• Name of the procedure.
• Database in which it is created.
• Type of the procedure.
• Creator of the procedure.
• Modification dates etc

Syntax

Following is the syntax the PROCEDURE STATUS statement −

SHOW PROCEDURE STATUS
   [LIKE 'pattern' | WHERE expr]

Example

Following statement displays the characteristics of stored procedures −

SHOW PROCEDURE STATUS\G;

Output

Following is the output of the above query −

************ 1. row ************
                  Db: test
                Name: areaOfCircle
                Type: PROCEDURE
             Definer: root@localhost
            Modified: ------------------
             Created: ------------------
       Security_type: DEFINER
             Comment:
character_set_client: cp850
collation_connection: cp850_general_ci
  Database Collation: utf8mb4_0900_ai_ci
************ 2. row ************
                  Db: test
                Name: case_example
                Type: PROCEDURE
             Definer: root@localhost
            Modified: ------------------
             Created: ------------------
       Security_type: DEFINER
             Comment:
character_set_client: cp850
collation_connection: cp850_general_ci
  Database Collation: utf8mb4_0900_ai_ci
************ 3. row ************
                  Db: test
                Name: coursedetails_CASE
                Type: PROCEDURE
             Definer: root@localhost
            Modified: ------------------
             Created: ------------------
       Security_type: DEFINER
             Comment:
character_set_client: cp850
collation_connection: cp850_general_ci
  Database Collation: utf8mb4_0900_ai_ci
************ 4. row ************
                  Db: test
                Name: curdemo
                Type: PROCEDURE
             Definer: root@localhost
            Modified: ------------------
             Created: ------------------
       Security_type: DEFINER
             Comment:
character_set_client: cp850
collation_connection: cp850_general_ci
  Database Collation: utf8mb4_0900_ai_ci
************ 5. row ************
Db: ooo
Name: cursorExample
Type: PROCEDURE
               Definer: root@localhost
            Modified: ------------------
             Created: ------------------
       Security_type: DEFINER
             Comment:
character_set_client: cp850
collation_connection: cp850_general_ci
  Database Collation: utf8mb4_0900_ai_ci
************ 6. row ************
                  Db: test
                Name: demo
                Type: PROCEDURE
             Definer: root@localhost
            Modified: ------------------
             Created: ------------------
       Security_type: DEFINER
             Comment:
character_set_client: cp850
collation_connection: cp850_general_ci
  Database Collation: utf8mb4_0900_ai_ci
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .

The LIKE clause

Using the LIKE clause, you can specify a pattern to retrieve information about the procedures.

Example

Assume we have created a new database and created 3 procedures in it using the CREATE statement as shown below −

SHOW CREATE demo;
use dem;
database changed
DELIMITER //
CREATE PROCEDURE sample1 ()
   BEGIN
      SELECT 'This is a sample procedure';
   END//
Query OK, 0 rows affected (0.29 sec)

CREATE PROCEDURE sample2 ()
   BEGIN
      SELECT 'This is a sample procedure';
   END//
Query OK, 0 rows affected (0.29 sec)

CREATE PROCEDURE sample3 ()
   BEGIN
      SELECT 'This is a sample procedure';
   END//
Query OK, 0 rows affected (0.29 sec)
CREATE PROCEDURE sample4 ()
   BEGIN
      SELECT 'This is a sample procedure';
   END//
DELIMITER ;

Following query retrieves the information about the procedures whose name starts with the letter "e".

SHOW PROCEDURE STATUS LIKE 'sample%'\G;

Output

The above query generates the output shown below −

************ 1. row ************
                      Db: demo
				    Name: sample1
				    Type: PROCEDURE
				 Definer: root@localhost
			    Modified: 2021-05-13 21:54:02
			     Created: 2021-05-13 21:54:02
		   Security_type: DEFINER
	             Comment:
	character_set_client: cp850
    collation_connection: cp850_general_ci
	  Database Collation: utf8mb4_0900_ai_ci	   
************ 2. row ************
                      Db: xo
				    Name: sample2
				    Type: PROCEDURE
				 Definer: root@localhost
			    Modified: 2021-05-13 21:54:07
			     Created: 2021-05-13 21:54:07
		   Security_type: DEFINER
	             Comment:
	character_set_client: cp850
    collation_connection: cp850_general_ci
	  Database Collation: utf8mb4_0900_ai_ci
************ 3. row ************
                      Db: xo
				    Name: sample3
				    Type: PROCEDURE
				 Definer: root@localhost
			    Modified: 2021-05-13 21:54:13
			     Created: 2021-05-13 21:54:13
		   Security_type: DEFINER
	             Comment: 
	character_set_client: cp850
    collation_connection: cp850_general_ci
	  Database Collation: utf8mb4_0900_ai_ci
************ 4. row ************
                      Db: xo
				    Name: sample4
				    Type: PROCEDURE
				 Definer: root@localhost
			    Modified: 2021-05-13 21:54:19
			     Created: 2021-05-13 21:54:19
		   Security_type: DEFINER
	             Comment: 
	character_set_client: cp850
    collation_connection: cp850_general_ci
	  Database Collation: utf8mb4_0900_ai_ci

The WHERE clause

You can use the WHERE clause of the SHOW PROCEDURE STATUS statements to retrieve information about the procedures which match the specified condition.

Example

Suppose we have created a table named Employee in the database as shown below −

CREATE TABLE Employee(
   Name VARCHAR(255), 
   Salary INT NOT NULL, 
   Location VARCHAR(255)
);

Let us created a stored procedure myProcedurewhich accepts the name, salary and location values and inserts them as a record into the above create table.

DELIMITER //
Create procedure myProcedure (
   IN name VARCHAR(30),
   IN sal INT,
   IN loc VARCHAR(45))
   BEGIN
      INSERT INTO Employee(Name, Salary, Location) VALUES (name, sal, loc);
   END //
DELIMITER ;

In the same way following procedure retrieves all the records of in the above created table −

Create procedure retrieveRecords ()
   BEGIN
      SELECT * FROM Dispatches;
   END //

IYou can verify the list of procedures in a database using the SHOW PROCEDURE STATUS statement as shown below −

SHOW PROCEDURE STATUS WHERE db = 'test'\G;

Output

Once the query is executed, it will generate the following output −

************ 1. row ************
                      Db: test
				    Name: myProcedure
				    Type: PROCEDURE
				 Definer: root@localhost
			    Modified: 2021-03-22 14:02:01
			     Created: 2021-03-22 14:01:42
		   Security_type: DEFINER
	             Comment: This is a sample comment
	character_set_client: cp850
    collation_connection: cp850_general_ci
	  Database Collation: utf8mb4_0900_ai_ci	   
************ 2. row ************
                      Db: test
				    Name: retrieveRecords
				    Type: PROCEDURE
				 Definer: root@localhost
			    Modified: 2021-03-22 15:15:09
			     Created: 2021-03-22 15:15:09
		   Security_type: DEFINER
	             Comment:
	character_set_client: cp850
    collation_connection: cp850_general_ci
	  Database Collation: utf8mb4_0900_ai_ci

Following queries deletes/drops the above created procedures −

DROP PROCEDURE myProcedure;

DROP PROCEDURE retrieveRecords;

Verification

Since we have deleted both the procedures. If you verify the list of procedures again you will get an empty set −

SHOW PROCEDURE STATUS WHERE db = 'test';
Empty set (0.00 sec)