Comment créer une procédure stockée SQL Server avec des paramètres ?
Pour rappel, une procédure stockée regroupe et ordonnance un ensemble de commandes SQL ou T-SQL. Comment intégrer dans une procédure stockée une requête SELECT sur la table Clients de notre base de données SQL Server ? Par exemple, au lieu d’afficher toutes les données de la table, pour afficher un seul client, il suffit de filtrer grâce au paramètre passé en entrée.
Table des matières
Créer une procédure stockée SQL Server avec des paramètres
Avant d’exécuter le script de création de la procédure stockée, créer au préalable la table Clients. Ensuite, utiliser ce script SQL Server pour créer la table des Clients. Pour rappel, voici le script pour créer la table depuis une fenêtre SSMS:
-- Créer la table CLIENTS avec la colonne NOM déclarée comme UNIQUE CREATE TABLE [dbo].[CLIENTS] ( [NOCLIENT] int IDENTITY(1,1), [NOM] nvarchar(20) UNIQUE, [VILLE] nvarchar(20) ) GO -- Insérer des données pour les exemples de manipulation INSERT INTO dbo.CLIENTS ( NOM, VILLE ) VALUES ( N'MAMMADOU', 'Lyon'); INSERT INTO dbo.CLIENTS ( NOM, VILLE ) VALUES ( N'SERGEI', 'Lyon'); INSERT INTO dbo.CLIENTS ( NOM, VILLE ) VALUES ( N'CHRISTOPHE', 'Paris'); -- Vérifier des lignes insérées SELECT * FROM dbo.CLIENTS;

1. Code T-SQL pour créer une procédure avec un seul paramètre
Voici un exemple de procédure stockée SQL qui utilise un seul et unique paramètre. Ce paramètre est le numéro de client. La procédure affiche le client dont le numéro est passé en paramètre. Pour appeler la procédure stockée, exécuter le code comme suit avec EXEC ou EXECUTE. Définir la variable avec un numéro de client.
CREATE PROCEDURE uspGetClient @NoClient INT AS SELECT * FROM [dbo].[CLIENTS] WHERE [NOCLIENT] = @NoClient GO EXEC uspGetClient @NoClient = 3;

2. Exécuter une procédure sans paramètre obligatoire génère une erreur
Dans l’exemple précédent, l’appel de la procédure transmet la valeur du paramètre. De la même manière, exécuter la procédure SQL Server sans définir de valeur au paramètre du numéro de client:
EXEC uspGetClient;
Alors le message d’erreur SQL suivant est affiché car le paramètre numéro de client est obligatoire et n’est pas de valeur par défaut assignée :
Msg 201, Level 16, State 4, Procedure uspGetClient, Line 0
Procedure or function ‘uspGetClient’ expects parameter ‘@NoClient’, which was not supplied.
3. Gérer la valeur par défaut des variables dans une procédure
Pour aller plus loin et gérer les valeurs par défaut, c’est simple, dans la plupart des cas, il est conseillé de passer une valeur aux paramètres. Dans la pratique, ce n’est pas toujours possible voire utile. Pour prévoir le cas où un appel à la procédure se fait sans paramètre, utiliser la valeur NULL. En effet NULL permet d’initialiser une valeur de paramètre dans la procédure et éviter les erreurs.
Après cela, exécuter cette deuxième version de la procédure stockée sans paramètre. Cette fois, aucune erreur et la requête ne retourne aucune ligne car tous les clients contenus dans la table ont un numéro de client.
-- Tester si la procédure existe et la supprimer IF EXISTS ( SELECT name FROM sysobjects WHERE name = 'uspGetClient' AND type = 'P' ) DROP PROCEDURE uspGetClient GO -- Créer la procédure avec une valeur par défaut CREATE PROCEDURE uspGetClient @NoClient int = NULL AS SELECT * FROM [dbo].[CLIENTS] WHERE [NOCLIENT] = @NoClient GO -- Exécuter la procédure stockée sans passer de paramètre EXEC uspGetClient;

4. Exemple de procédure stockée avec plusieurs paramètres
C’est le même principe qu’avec un paramètre unique, et il faut lister, initialiser et appeler chaque paramètre indépendamment. Ainsi, énumérer et séparer par une virgule chaque paramètre et son type de données, comme dans cet exemple de code SQL :
-- Tester si la procédure existe et la supprimer IF EXISTS ( SELECT name FROM sysobjects WHERE name = 'uspGetClient' AND type = 'P' ) DROP PROCEDURE uspGetClient GO -- Créer la même procédure avec deux paramètres et les valeurs par défaut CREATE PROCEDURE uspGetClient @NoClient int = NULL, @Ville nvarchar(20) = NULL AS SELECT * FROM [dbo].[CLIENTS] WHERE [NOCLIENT] = @NoClient OR [VILLE] = @Ville GO -- Appeler la procédure avec différentes combinaisons de paramètres EXEC uspGetClient @NoClient = 1, @Ville = 'Lyon'; EXEC uspGetClient @NoClient = 1; EXEC uspGetClient @Ville = 'Paris';
En effet, on peut appeler chacun des paramètres seuls, ou les deux simultanément. Il est possible de ne passer aucun paramètre car la procédure initialise les valeurs par défaut avec la valeur NULL.

Enfin, appeler la procédure stockée uspGetClient sans paramètre est aussi possible. Elle retourne dans ce cas toutes les données contenues dans la table Clients. Car c’est l’opérateur logique OR qui est utilisé dans la clause WHERE et donc le filtre ne s’applique pas. En conclusion, cet article explique pas à pas comment créer une procédure stockée SQL Server avec des paramètres. Un autre tutoriel explique comment créer une requête SQL d’insertion directement depuis une requête de sélection.
Vous trouvez cet article utile? Partagez-le.
Je n’ai pas bien compris la différence entre la table Clients, qu’on a dû créer avant,
et la table des clients, que le script va créer.
Le premier script permet de créer la table des clients et les scripts suivants de type CREATE PROCEDURE ou EXEC créent et exécutent des procédures stockées pour utiliser et lire les données de la table des clients.