Easy-to-follow video tutorials help you learn software, creative, and business skills.Become a member

Using input and output parameters

From: SQL Server: Triggers, Stored Procedures, and Functions

Video: Using input and output parameters

Now I'd like to talk about sending input parameters and returning output parameters from a stored procedure. These are optional. We have worked with stored procedures thus far without working with parameters, so they are optional. I have some code on the screen. It's available in our exercise files. It basically alters the stored procedure and then executes the stored procedure. So I am going to alter the stored procedure to include a 1 input parameter for now. I do that by creating some parentheses.

Using input and output parameters

Now I'd like to talk about sending input parameters and returning output parameters from a stored procedure. These are optional. We have worked with stored procedures thus far without working with parameters, so they are optional. I have some code on the screen. It's available in our exercise files. It basically alters the stored procedure and then executes the stored procedure. So I am going to alter the stored procedure to include a 1 input parameter for now. I do that by creating some parentheses.

We will need to put all of our parameters in parentheses. Then I need to give the parameter a name. And remember, in SQL Server, variable names always start with the at sign, and beyond that, you can name it almost anything you would like to name it. We will also need to declare what datatype we're going to use. Any of the typical SQL Server datatypes are in play, so for example, integer, varchar, datetime, all of those are perfectly valid. So I will declare this one as an integer.

So we're going to alter this procedure to now accept one parameter. That parameter is called @param1. We can reference that parameter throughout our code, and I will also alter our stored procedure to select parameter 1. So rather than select some arbitrary text, it's going to select that parameter that we passed to it. The code on top is now ready to go. It will successfully alter the stored procedure. The code on the bottom will need to be modified to pass it a parameter. The stored procedure is now expecting a parameter.

So we had better pass it a parameter and that parameter had better be an integer. So I will just pass it the integer 12. We'll run that. And it behaves as expected. Our code passed the parameter 12 to the stored procedure, and that exact value was returned to us. No surprises there. We'll call this a success. A few little notes on the syntax, when you are passing the parameter, you should not use parentheses. Although your instincts may tell you to use parentheses, you will in fact get an error if you use the parentheses.

So no parentheses when passing parameters. And also like I mentioned, it has to in fact be an integer. If I try to pass it some text, the machine will also get upset about that. It says error converting from varchar to integer and that is expected. So that's the basics of an input parameter. We could do multiple input parameters. I will come back up here to my parameter list, and put a single comma, and then I can list a second parameter. And again, it will need a datatype, and again, I will have to come down here, and make sure I am passing a second parameter to it, and that runs successfully.

We haven't actually done anything with the second parameter, so this becomes mildly more interesting, if we go ahead and display both parameter 1 and parameter 2. So no surprises there. We passed it the value 12 and Hello. It returned the value 12 and Hello. This is good. So now we've successfully worked with input parameters and we want to talk a little bit about output parameters. So we want to take this value that's being passed to it. Parameter 1 has a value of 12 and we're going to modify that value and then read the value as it comes out.

In order to do this, I will need to change a little bit of the code around the execute statement. Rather than just pass it the value 12, I want to pass it a variable. I will declare a new variable, just call it X, and we'll have to say that it is an integer, and I will go ahead and give it the value. We will then pass that variable to the stored procedure, and then we will read the value of that variable. And if all goes well, once we're done with this, it will be changing the value of that variable.

We haven't written the code for that just yet. But we can see it successfully passes the value of 13, and then reads the value of 13, as we are now, it is expected. So let's go ahead and try to change the value of the parameter. And here, we can say SET @param1 equal to some value other than 13; I will just choose a random number, 27. So what's going on here is lines 11, 12, and 13, should pass the value 13 to the stored procedure, the stored procedure should change that to 27, and then we can read that value.

This is not going to work just yet though. There is one more step that is a little counterintuitive to some people. We have to actually declare the parameter to be an output parameter. SQL Server assumes all parameters are input only. So if you would like them to be output, you have to specifically use the keyword OUTPUT in line 1 where we declare the stored procedure, we have to specifically say OUTPUT. And then again, on line 12 where we are passing the parameter, we also have to say specifically OUTPUT.

Now we should be able to successfully return the value 27. That is in fact what's happening. We've had success. So again, parameters are assumed to be input values. If you would like them to be both input and output, you have to use the keyword OUTPUT, and you have to use that keyword twice. We have to use output once when you declare the stored procedure, and once where we execute the stored procedure.

Show transcript

This video is part of

Image for SQL Server: Triggers, Stored Procedures, and Functions
 
Expand all | Collapse all
  1. 2m 15s
    1. Welcome
      51s
    2. What you should know
      51s
    3. Using the exercise files
      33s
  2. 11m 1s
    1. Comparing triggers, functions, and procedures
      3m 25s
    2. Why use a stored procedure?
      4m 59s
    3. Why use functions?
      1m 27s
    4. Why use triggers?
      1m 10s
  3. 6m 2s
    1. Configuring your environment
      4m 53s
    2. Downloading and installing a sample database
      1m 9s
  4. 26m 25s
    1. Creating a stored procedure
      2m 46s
    2. Modifying a stored procedure
      2m 34s
    3. Returning data using data sets
      3m 45s
    4. Returning data using cursors
      3m 45s
    5. Using input and output parameters
      5m 24s
    6. Using security and permissions
      5m 24s
    7. Using transactions
      2m 47s
  5. 11m 56s
    1. Creating a user-defined function
      4m 59s
    2. Exploring single-value functions
      4m 18s
    3. Exploring table value functions
      2m 39s
  6. 9m 31s
    1. Using "after" triggers
      3m 47s
    2. Using "instead of" triggers
      2m 9s
    3. Using nested triggers
      1m 38s
    4. Using database-level triggers
      1m 57s
  7. 12m 43s
    1. Exploring a real-world INSERT procedure
      5m 32s
    2. Exploring a real-world UPDATE procedure
      3m 13s
    3. Implementing logging on DELETE
      3m 58s
  8. 19m 38s
    1. Understanding the Common Language Runtime (CLR) and the .NET framework
      1m 52s
    2. Using CLR with SQL Server 2012
      4m 11s
    3. Writing stored procedures with C# .NET
      5m 51s
    4. Writing functions with .NET
      5m 7s
    5. Choosing between T-SQL vs. CLR
      2m 37s
  9. 11m 34s
    1. Creating a basic web form and connecting to a database
      2m 56s
    2. Executing a stored procedure
      2m 4s
    3. Passing parameters
      3m 41s
    4. Getting return values
      2m 53s
  10. 1m 43s
    1. Next steps
      1m 43s

Start learning today

Get unlimited access to all courses for just $25/month.

Become a member
Sometimes @lynda teaches me how to use a program and sometimes Lynda.com changes my life forever. @JosefShutter
@lynda lynda.com is an absolute life saver when it comes to learning todays software. Definitely recommend it! #higherlearning @Michael_Caraway
@lynda The best thing online! Your database of courses is great! To the mark and very helpful. Thanks! @ru22more
Got to create something yesterday I never thought I could do. #thanks @lynda @Ngventurella
I really do love @lynda as a learning platform. Never stop learning and developing, it’s probably our greatest gift as a species! @soundslikedavid
@lynda just subscribed to lynda.com all I can say its brilliant join now trust me @ButchSamurai
@lynda is an awesome resource. The membership is priceless if you take advantage of it. @diabetic_techie
One of the best decision I made this year. Buy a 1yr subscription to @lynda @cybercaptive
guys lynda.com (@lynda) is the best. So far I’ve learned Java, principles of OO programming, and now learning about MS project @lucasmitchell
Signed back up to @lynda dot com. I’ve missed it!! Proper geeking out right now! #timetolearn #geek @JayGodbold
Share a link to this course

What are exercise files?

Exercise files are the same files the author uses in the course. Save time by downloading the author's files instead of setting up your own files, and learn by following along with the instructor.

Can I take this course without the exercise files?

Yes! If you decide you would like the exercise files later, you can upgrade to a premium account any time.

Become a member Download sample files See plans and pricing

Please wait... please wait ...
Upgrade to get access to exercise files.

Exercise files video

How to use exercise files.

Learn by watching, listening, and doing, Exercise files are the same files the author uses in the course, so you can download them and follow along Premium memberships include access to all exercise files in the library.


Exercise files

Exercise files video

How to use exercise files.

For additional information on downloading and using exercise files, watch our instructional video or read the instructions in the FAQ.

This course includes free exercise files, so you can practice while you watch the course. To access all the exercise files in our library, become a Premium Member.

Are you sure you want to mark all the videos in this course as unwatched?

This will not affect your course history, your reports, or your certificates of completion for this course.


Mark all as unwatched Cancel

Congratulations

You have completed SQL Server: Triggers, Stored Procedures, and Functions.

Return to your organization's learning portal to continue training, or close this page.


OK
Become a member to add this course to a playlist

Join today and get unlimited access to the entire library of video courses—and create as many playlists as you like.

Get started

Already a member?

Become a member to like this course.

Join today and get unlimited access to the entire library of video courses.

Get started

Already a member?

Exercise files

Learn by watching, listening, and doing! Exercise files are the same files the author uses in the course, so you can download them and follow along. Exercise files are available with all Premium memberships. Learn more

Get started

Already a Premium member?

Exercise files video

How to use exercise files.

Ask a question

Thanks for contacting us.
You’ll hear from our Customer Service team within 24 hours.

Please enter the text shown below:

The classic layout automatically defaults to the latest Flash Player.

To choose a different player, hold the cursor over your name at the top right of any lynda.com page and choose Site preferencesfrom the dropdown menu.

Continue to classic layout Stay on new layout
Exercise files

Access exercise files from a button right under the course name.

Mark videos as unwatched

Remove icons showing you already watched videos if you want to start over.

Control your viewing experience

Make the video wide, narrow, full-screen, or pop the player out of the page into its own window.

Interactive transcripts

Click on text in the transcript to jump to that spot in the video. As the video plays, the relevant spot in the transcript will be highlighted.

Are you sure you want to delete this note?

No

Your file was successfully uploaded.

Thanks for signing up.

We’ll send you a confirmation email shortly.


Sign up and receive emails about lynda.com and our online training library:

Here’s our privacy policy with more details about how we handle your information.

Keep up with news, tips, and latest courses with emails from lynda.com.

Sign up and receive emails about lynda.com and our online training library:

Here’s our privacy policy with more details about how we handle your information.

   
submit Lightbox submit clicked
Terms and conditions of use

We've updated our terms and conditions (now called terms of service).Go
Review and accept our updated terms of service.