//  home   //  advanced search   //  news   //  categories   //  sql build chart   //  downloads   //  statistics
 ASP FAQ 
Home
ASP FAQ Tutorials

   8000XXXX Errors
   ASP.NET 2.0
   Classic ASP 1.0
   Databases
      Access DB & ADO
      General SQL Server & Access Articles
      MySQL
      Other Articles
      Schema Tutorials
      Sql Server 2000
      Sql Server 2005
   General Concepts
   Search Engine Optimization (SEO)

Contact Us
Site Map

Search

Web
aspfaq.com
tutorials.aspfaq.com
sqlserver2000.databases.aspfaq.com

ASP FAQ Tutorials :: Databases :: Sql Server 2000 :: Can I have optional parameters to my stored procedures?


Can I have optional parameters to my stored procedures?

Yes, you can have a stored procedure that has optional parameters. You can do this by setting a default value for each parameter that you want to make optional. The default value is typically NULL, but it doesn't have to be. Here is some sample code, ready to test in Query Analyzer: 
 
CREATE PROCEDURE dbo.foo 
    @param1 VARCHAR(32) = NULL, 
    @param2 INT = NULL 
AS 
BEGIN 
    SET NOCOUNT ON 
 
    SELECT Param1 = COALESCE 
    ( 
        @param1, 
        '@param1 was empty' 
    ) 
    SELECT Param2 = COALESCE 
    ( 
        RTRIM(@param2), 
        '@param2 was empty' 
    ) 
END 
GO 
 
EXEC dbo.foo @param1='bar', @param2=4 
EXEC dbo.foo @param1='bar' 
EXEC dbo.foo @param2=4 
EXEC dbo.foo 'bar',4 
EXEC dbo.foo 'bar' 
 
EXEC dbo.foo 
GO 
 
DROP PROCEDURE dbo.foo 
GO
 
For a more realistic example, let's say you are using the Pubs database and want to return specific last names if a last name is entered, otherwise you want to return everyone. 
 
USE Pubs 
GO 
 
CREATE PROCEDURE dbo.GetAuthors 
    @lastName VARCHAR(32) = NULL 
AS 
BEGIN 
    SET NOCOUNT ON 
 
    SELECT * FROM Authors 
        WHERE AU_LName LIKE COALESCE(@lastName, '%') 
END 
GO
 
You may be tempted to use a slightly different method, e.g.: 
 
WHERE AU_LName = COALESCE(@LastName, AU_LName) 
 
WHERE AU_LName = CASE WHEN @lastName IS NULL THEN AU_LName ELSE @LastName END
 
However, you will find the best execution plan is the method I demonstrated within the stored procedure. In the following example, you will see index seeks for GetAuthors1 and GetAuthors2, but index scans on the others (and you will see a big difference in the statistics and amount of work). Turn on Execution Plan (Ctrl+K) in Query Analyzer when running this script: 
 
USE Pubs 
GO 
 
CREATE PROCEDURE dbo.GetAuthors1 
    @lastName VARCHAR(32) = NULL 
AS 
BEGIN 
    SET NOCOUNT ON 
 
    SELECT * FROM Authors 
        WHERE AU_LName LIKE COALESCE(@lastName, '%') 
END 
GO 
 
CREATE PROCEDURE dbo.GetAuthors2 
    @lastName VARCHAR(32) = NULL 
AS 
BEGIN 
    SET NOCOUNT ON 
 
    SELECT * FROM Authors 
        WHERE AU_LName LIKE ISNULL(@lastName, '%') 
END 
GO 
 
CREATE PROCEDURE dbo.GetAuthors3 
    @lastName VARCHAR(32) = NULL 
AS 
BEGIN 
    SET NOCOUNT ON 
 
    SELECT * FROM Authors 
        WHERE AU_LName = COALESCE(@lastName, AU_LName) 
END 
GO 
 
CREATE PROCEDURE dbo.GetAuthors4 
    @lastName VARCHAR(32) = NULL 
AS 
BEGIN 
    SET NOCOUNT ON 
 
    SELECT * FROM Authors 
        WHERE AU_LName = ISNULL(@lastName, AU_LName) 
END 
GO 
 
CREATE PROCEDURE dbo.GetAuthors5 
    @lastName VARCHAR(32) = NULL 
AS 
BEGIN 
    SET NOCOUNT ON 
 
    SELECT * FROM Authors 
        WHERE AU_LName = CASE 
            WHEN @lastName IS NULL THEN AU_LName 
            ELSE @lastName END 
END 
GO 
 
 
EXEC dbo.GetAuthors1 
EXEC dbo.GetAuthors2 
EXEC dbo.GetAuthors3 
EXEC dbo.GetAuthors4 
EXEC dbo.GetAuthors5 
 
EXEC dbo.GetAuthors1 'Carson' 
EXEC dbo.GetAuthors2 'Carson' 
EXEC dbo.GetAuthors3 'Carson' 
EXEC dbo.GetAuthors4 'Carson' 
EXEC dbo.GetAuthors5 'Carson' 
GO 
 
DROP PROCEDURE dbo.GetAuthors1 
DROP PROCEDURE dbo.GetAuthors2 
DROP PROCEDURE dbo.GetAuthors3 
DROP PROCEDURE dbo.GetAuthors4 
DROP PROCEDURE dbo.GetAuthors5 
GO
 
(For more information on COALESCE vs. ISNULL, see Article #2532.) 
 
Access 
For an Access stored query, you can use the following logic: 
 
PARAMETERS Param1 VARCHAR(32), Param2 INT; 
SELECT columns FROM table WHERE 
    ([Param1] IS NULL OR column1 = [Param1]) 
    AND 
    ([Param2] IS NULL OR column2 = [Param2])

Related Articles

Are there tools available for auditing changes to SQL Server data?
Can I create an index on a BIT column?
Can I implement an input mask in SQL Server?
Can I make SQL Server format dates and times for me?
Can I start IDENTITY values at a new seed?
Can SQL Server tell me which row was inserted most recently?
How can I learn more about undocumented SQL Server stored procedures?
How can I make my SQL queries case sensitive?
How do I audit changes to SQL Server data?
How do I connect to a non-default instance of SQL Server?
How do I connect to SQL Server on a port other than 1433?
How do I create a cross-tab (or "pivot") query?
How do I determine if a table exists in a SQL Server database?
How do I drop a SQL Server database?
How do I find all the available SQL Servers on my network?
How do I get a list of SQL Server tables and their row counts?
How do I get rid of Named Pipes / DBNMPNTW errors?
How do I get the correct date/time from the msdb.sysjob* tables?
How do I get the nth row in a SQL Server table?
How do I get the result of dynamic SQL into a variable?
How do I handle REPLACE() within an NTEXT column in SQL Server?
How do I hide system tables in SQL Server's Enterprise Manager?
How do I know which version of SQL Server I'm running?
How do I limit the number of rows returned in my resultset?
How do I load text or csv file data into SQL Server?
How do I manage changes in SQL Server objects?
How do I monitor SQL Server performance?
How do I prevent linked server errors?
How do I reclaim space in SQL Server?
How do I recover data from SQL Server's log files?
How do I search for special characters (e.g. %) in SQL Server?
How do I start SQL Server Agent from ASP?
How do I time my T-SQL code?
How do I upsize from Access to SQL Server?
How do I upsize my MSDE database to full-blown SQL Server 2000?
How do I use a variable in a TOP clause in SQL Server?
How do I use GETDATE() within a User-Defined Function (UDF)?
How should I store an IP address in SQL Server?
Schema: How do I find all the foreign keys in a database?
SQL Server & MSDE
What are reserved Access, ODBC and SQL Server keywords?
What are the capacities of Access, SQL Server, and MSDE?
What are the main differences between Access and SQL Server?
What do I need to know about SQL Server 2000 SP4?
Where else can I learn about SQL Server?
Where is SP4 for SQL Server 2000?
Why am I having problems with SQL Server 2000 SP3 / SP3a?
Why can't I install SQL Server on Windows Server 2003?
Why can't I install SQL Server on Windows XP?
Why can't I use LIKE '%datepart%' queries?
Why do I get "Login failed for user '\'."?
Why do I get 'object could not be found' or 'invalid object name'?
Why do I get errors about master..spt_values?
Why do I get script errors in Enterprise Manager's 'taskpad' view?
Why do I get SQLSetConnectAttr Failed errors?
Why do I have problems with views after altering the base table?
Why does EM crash when I get an error in a stored procedure?
Why does Enterprise Manager return 'Invalid cursor state'?
Why does my DELETE query not work?
Why does sp_spaceused return inaccurate values?
Why is Enterprise Manager slow at expanding my database list?
Why is my app slow after upgrading from SQL Server 7 to 2000?
Why is tempdb full, and how can I prevent this from happening?
Why should I consider using an auxiliary calendar table?
Why should I consider using an auxiliary numbers table?

 

 


Created: 8/10/2002 | Last Updated: 1/23/2005 | broken links | helpful | not helpful | statistics
© Copyright 2006, UBR, Inc. All Rights Reserved. (143)

 

Copyright 1999-2006, All rights reserved.
Finding content
Finding content.  An error has occured...