Create A Stored Procedure In SQL Server

In this article you will learn about how to create a stored procedure in SQL. This article covers answers to the following questions,

1. What is a stored procedure in SQL?
2. Why do we use SET NOCOUNT ON in a stored procedure?
3. How many types of stored procedure are there?
4. How to write comments in SQL Server?
5. What are the naming conventions for stored procedures?
6. How to create a stored procedure to select data from a database tabe using SELECT SQL query?
7. How to execute stored procedures in SQL Server?
8. What is are parameters in stored procedures?
9. How to create parameters in a SELECT query stored procedure which return records as per parameter passed?
10. How to create an INSERT query based stored procedure?
11. How to create an UPDATE query based stored procedure?
12. How to create a stored procedure to delete records using DELETE query?

What is a Stored Procedure?

 

A SQL stored procedure (SP) is a collection SQL statements and sql command logic, which is compiled and stored on the database. Stored procedues in SQL allows us to create SQL queries to be stored and executed on the server. Stored procedures can also be cached and reused. The main purpose of stored procedures to hide direct SQL queries from the code and improve performance of database operations such as select, update, and delete data.

 

You can create and execute stored procedures using the Object Explorer in SQL Server or using SQL Server Management Studio (SSMS). If you're new to SSMS, try this: https://www.c-sharpcorner.com/article/sql-server-management-studio/ 

 

Why do we use SET NOCOUNT ON in a stored procedure?

 

While we set SET NOCOUNT ON it means there is no messages which shows the number of rows affected.

 

NOCOUNT means do not count that is ON. 

 

Now you will come to know what happened when SET NOCOUNT OFF.

 

Types of stored procedures

 

There are two types of stored procedures available in SQL Server:

1. User defined stored procedures
2. System stored procedures

User defined stored procedures

 

User defined stored procedures are created by database developers or database administrators. These SPs contains one more more SQL statements to select, update, or delete records from database tables. User defined stored procedure can take input parameters and return output parameters. User defined stored procedure is mixture of DDL (Data Definition Language) and DML (Data Manipulation Language ) commands.

 

User defined SPs are further classified into two types:

 

T-SQL stored procedures: T-SQL (Transact SQL) SPs receive and returns parameters. These SPs process the Insert, Update and Delete queries with or without parameters and return data of rows as output. This is one of the most common ways to write SPs in SQL Server.

 

CLR stored procedures: CLR (Common Language Runtime) SPs are written in a CLR based programming language such as C# or VB.NET and are executed by the .NET Framework.

 

System stored procedures

 

System stored procedyres are created and executed by SQL Server for the server administrative activities. Developers usually don't interfere with system SPs. 

 

Login to SQL Server database

 

Let's login to our SQL Server database, so we can achieve the folowing:

• How to create a SELECT QUERY based stored procedure which return all records?
• How to create a PARAMETER based SELECT QUERY stored procedure which return records based on parameters?
• How to create an INSERT query based stored procedure?
• How to create an UPDATE query based stored procedure?
• How to create a DELETE query based stored procedure?

Login in SQL SERVER with your Server Name, Login and Password.

 

 

 

Switch to your database. My database name is MBKTest.

 

 

 

Empty stored procedure will be created using the following:

 

 

 

The empty template created by SQL Server for a SP looks like the following. The CREATE PROCEDURE SQL command is used to create a procedure, followed by a SP name and its parameters. The BEGIN and END area is used to define the query for the operation. This is where you will write a select, update, insert, or delete queries. 

-- ================================================
-- Template generated from Template Explorer using:
-- Create Procedure (New Menu).SQL
--
-- Use the Specify Values for Template Parameters
-- command (Ctrl-Shift-M) to fill in the parameter
-- values below.
--
-- This block of comments will not be included in
-- the definition of the procedure.
-- ================================================
SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
-- =============================================
-- Author:      <Author,,Name>
-- Create date: <Create Date,,>
-- Description: <Description,,>
-- =============================================
CREATE PROCEDURE <Procedure_Name, sysname, ProcedureName>
    -- Add the parameters for the stored procedure here
    <@Param1, sysname, @p1> <Datatype_For_Param1, , int> = <Default_Value_For_Param1, , 0>,
    <@Param2, sysname, @p2> <Datatype_For_Param2, , int> = <Default_Value_For_Param2, , 0>
AS
BEGIN
    -- SET NOCOUNT ON added to prevent extra result sets from
    -- interfering with SELECT statements.
    SET NOCOUNT ON;

    -- Insert statements for procedure here
    SELECT <@Param1, sysname, @p1>, <@Param2, sysname, @p2>
END
GO

How to write comments in SQL SERVER?

 

You can comment in sql server in the following ways,

1. -- (two hyphens / dash) for a single line of comment.
2. start with /* ……. end with  */    for multiline comments.

What is the naming convention for stored procedures?

 

We must follow standard naming conventions which may also depend on your project and coding policies.

For user defined stored procedure naming conventions, my suggestions are to add one of the following prefixes to your SP names.

1. sp
2. stp
3. stp_
4. udstp
5. udstp_

Naming conventions are just to identify objects. By adding these prefixes in the name, we can clearly identify that this object is a stored procedure. 

 

Create a database table

 

Before, we can create and execute any SPs, we need a database table. I create a database table named, “tblMembers” using the following SQL query and execute it on the server. As you can see, my table has 4 column where the first column is an idenity column. Once the table is created, open table in your SSMS and add some data by manually entering data to the table.

USE [MBKTest]
GO

/****** Object:  Table [dbo].[tblMembers]    Script Date: 18-Nov-17,Sat 6:47:55 PM ******/
SET ANSI_NULLS ON
GO

SET QUOTED_IDENTIFIER ON
GO

SET ANSI_PADDING ON
GO

CREATE TABLE [dbo].[tblMembers](
    [MemberID] [int] IDENTITY(1,1) NOT NULL,
    [MemberName] [varchar](50) NULL,
    [MemberCity] [varchar](25) NULL,
    [MemberPhone] [varchar](15) NULL
)

GO

SET ANSI_PADDING OFF
GO

How to create a SELECT stored procedure?

 

Click on your Database and expand “Programmability” item and right click on “Stored Procedures” or press CTRL + N to get new query window. In the query area between BEGIN and END, type your SELECT statement to select records from the table. See the Select statement in the below code.

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
-- =============================================
-- Author:      Manoj Kalla
-- Create date: 18th Nov 2017
-- Description: Return all members
-- =============================================
--Store procedure name is --> stpGetAllMembers
CREATE PROCEDURE stpGetAllMembers
AS
BEGIN
    -- SET NOCOUNT ON added to prevent extra result sets from
    -- interfering with SELECT statements.
    SET NOCOUNT ON;

    -- Select statements for procedure here
    Select * from tblMembers
END
GO

Now, press F5 or click on Execute button to execute the SP.

 

 

 

 

You should see a message, “Command(s) completed successfully.”

 

Now go to Programmability -->Stored Procedures, Right Click and select Refresh.

 

You can see in the following image, the new SP called stpGetAllMembers is created.

 

 

 

Execute stored procedures in SQL Server

 

In below UI, right click on the SP name and select Execute Stored Procedure... to execute a SP. From here, you can also modify an exisitng SP.

 

 

 

Alternatively, you can also execute a SP from the Query window. 

 

To run stored procedure in SQL Server Management Studio, switch to Query window or CTRL +N to open an new query window and type the following command. 

• Syntax - EXEC <stored procedure name>
• Example - EXEC stpGetAllMembers

Now, we run our stored procedure called stpGetAllMembers. The output looks like the following:

 

OUTPUT

 

 

 

What are parameters in stored procedures?

 

Parameters in SPs are used to pass input values and return output values. There are two types of parameters:

1. Input parameters - Pass values to a stored procedure.
2. Output parameters - Return values from a stored procedure.

How to create a SELECT query SP with parameters?

 

In the previous steps, we created a simple SP that returned all rows from a table. Now, let's create a new SP that will take a city name as an inpurt parameter and will return all rows where city name matches the input parameter value.

 

Here is the updated SP with a parameter @CityName.

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
-- =============================================
-- Author:      Manoj Kalla
-- Create date: 20-Nov-2017
-- Description: Return specifc city records
-- =============================================
CREATE PROCEDURE stpGetMembersByCityName
    -- Add the parameters for the stored procedure here
    @CityName nvarchar(30)

AS
BEGIN
    -- SET NOCOUNT ON added to prevent extra result sets from
    -- interfering with SELECT statements.
    SET NOCOUNT ON;

    Select * From tblMembers
    where MemberCity like '%'+@CityName+'%'

END
GO

Execute it.

 

To run this SP, type the following command in SQL query tool:

 

EXEC GetMemberByCityName   @CityName = 'mal'

 

OR from the UI, run the SP and provide the following input.

 

 

 

The code to execute looks like the following:

USE [MBKTest]
GO

DECLARE @return_value int

EXEC    @return_value = [dbo].[GetMemberByCityName]
        @CityName = N'mal'

SELECT  'Return Value' = @return_value

GO

OUTPUT

 

 

 

How to create a INSERT query based stored procedure?

 

We can use an INSERT INTO SQL query to insert data into a table. The following SQL statement creates an INSERT SP with three parameters.

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
-- =============================================
-- Author:      Manoj Kalla
-- Create date: 20-Nov-2047
-- Description: To create a new member
-- =============================================
CREATE PROCEDURE stpInsertMember
@MemberName varchar(50),
@MemberCity varchar(25),
@MemberPhone varchar(15)

AS
BEGIN
    -- SET NOCOUNT ON added to prevent extra result sets from
    -- interfering with SELECT statements.
    SET NOCOUNT ON;

    Insert into tblMembers (MemberName,MemberCity,MemberPhone)
           Values (@MemberName,@MemberCity, @MemberPhone)

END
GO

Right click on stored procedure in Object Explorer and select Refresh.

 

 

 

Pass the value of parameter in Execute dialog box. Something like this:

 

 

 

The following code can be used to execute this SP in SSMS. 

USE [MBKTest]
GO

DECLARE @return_value int

EXEC    @return_value = [dbo].[stpInsertMember]
        @MemberName = N'Mahesh Chand',
        @MemberCity = N'NewYork',
        @MemberPhone = N'9999945121'
SELECT  'Return Value' = @return_value
GO

OUTPUT

 

In the query window, you can check if a new record for Member Name 'Mahesh Chand' is added to the table.

 

 

 

You can also run the same SP in code.

 

EXEC stpInsertMember @MemberName = 'Suhana & Ashish Kalla ', @MemberCity = 'Mumbai ', @MemberPhone = N'9022592774xxx'

 

 

 

OUTPUT

 

You can check “Suhana & Ashish Kalla” record is added successfully.

 

 

 

How to create an UPDATE quert based stored procedure?

 

Let's create a new SP that will update a table records based on the Member ID column. The ID is passed as an input parameter. Here is the new SP that uses an UPDATE..SET..WHERE command.

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
-- =============================================
-- Author:      Manoj Kalla
-- Create date: 20-Nov-2017
-- Description: Update a member detail by ID
-- =============================================
CREATE PROCEDURE stpUpdateMemberByID
@MemberID int,
@MemberName varchar(50),
@MemberCity varchar(25),
@MemberPhone varchar(15)

AS
BEGIN
    -- SET NOCOUNT ON added to prevent extra result sets from
    -- interfering with SELECT statements.
    SET NOCOUNT ON;

    UPDATE tblMembers
    Set MemberName = @MemberName,
        MemberCity = @MemberCity,
        MemberPhone = @MemberPhone
    Where MemberID = @MemberID
END
GO

Right click on stored procedure in the Object Explorer and select Refresh. You will see the SP is created.

 

Now, Right click on SP name and select Execute stored procedure…. Provide the input values and execute.

 

 

 

We can use the following command in SSMS. 

USE [MBKTest]
GO

DECLARE @return_value int

EXEC    @return_value = [dbo].[stpUpdateMemberByID]
        @MemberID = 20,
        @MemberName = N'Nirupama Kalla',
        @MemberCity = N'Mumbai',
        @MemberPhone = N'904512541xxxx'

SELECT  'Return Value' = @return_value

GO

EXEC stpUpdateMemberByID  17,'Gopal Madhavrai','Bikaner','90454564xxx'

 

The results should show you the updated values.

 

 

 

How to create a DELETE query based stored procedure?

 

Let's create a SP that will delete records. The new SP uses a DELETE command and delete all records that matches provided Member ID.

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
-- =============================================
-- Author:      Manoj Kalla
-- Create date: 21-Nov-2017
-- Description: Delete a Member by Member ID
-- =============================================
CREATE PROCEDURE stpDeleteMemberByMemberID
    @MemberID int
AS
BEGIN
    -- SET NOCOUNT ON added to prevent extra result sets from
    -- interfering with SELECT statements.
    SET NOCOUNT ON;

    Delete from tblMembers
    where MemberId = @MemberID

END
GO

Execute it.

 

Right click on Stored Procedures in the Object Explorer and select Refresh.

 

RUN stored procedure BY UI

 

Now again right click on stored procedure and select Execute stored procedure…

 

As you can see in the image, I passed @MemberID parameter value = 4.

 

 

 

RUN DELETE stored procedure BY MANUALLY (CODING)

 

EXEC stpDeleteMemberByMemberID  2

 

OUTPUT

 

You can see in image MemberID = 4 record has been deleted successfully.

 

 

 

In this article, we saw how to create stored procedures in a SQL Server database for inserting, updating, and deleting records.