Utilisation des procédures stockées

Auteur : Équipe IIS

Prérequis

Cette procédure pas à pas suppose l’environnement suivant :

1. Le Gestionnaire de base de données IIS est installé sur votre serveur web.
2. Un serveur de base de données (qui peut résider sur la même machine physique que votre serveur web)

Configuration de l’étape

Les instructions trouvées dans cette procédure pas à pas sont suffisamment génériques pour être appliquées à n’importe quel déploiement de base de données. Nous allons utiliser les tableaux que nous avons créés dans une autre procédure pas à pas «Utilisation de tableaux» pour vous montrer comment créer de nouvelles procédures stockées et gérer et supprimer des procédures existantes.

Créez une nouvelle procédure stockée

En fonction de notre exemple précédent, nous allons créer une procédure stockée qui affiche les données des tableaux « FabrikamUsers » et « AccessControls ». La procédure stockée récupère toutes les ressources associées à un nom d’utilisateur. Pour créer une procédure stockée :

1. Ouvrez Gestionnaire des services Internet (IIS) .

2. Accédez au Gestionnaire de bases de données et développez votre nœud de connexion de base de données (pour plus d’informations sur la création de connexions à une base de données, consultez Les bases du Gestionnaire de base de données IIS).

3. Dans le nœud « Procédures stockées », cliquez avec le bouton droit et sélectionnez « Nouvelle procédure stockée ». Un nouvel éditeur de requête s’ouvre et est prérempli avec un modèle « CREATE PROCEDURE » pour vous aider à commencer.
   

4. Remplacez « Procedure_Name » par « GetUserResources ».

5. Remplacez le texte du modèle de paramètres par le texte du seul paramètre dont nous avons besoin :

   @Username VARCHAR(50)
   

6. Dans le corps de la procédure stockée, entre BEGIN et END, tapez la requête suivante :

   SELECT FabrikamUsers.Username, AccessControls.ResourceURL, AccessControls.IsUserAllowed
   FROM FabrikamUsers
   INNER JOIN AccessControls ON (FabrikamUsers.UserId = AccessControls.UserId)
   WHERE FabrikamUsers.Username = @Username
   

   

7. Cliquez sur « Exécuter » dans la barre d’outils de l’éditeur de requête. La procédure stockée est désormais créée. Vous pouvez confirmer que la procédure stockée a été créée en inspectant la liste des procédures stockées sous le nœud « Procédures stockées ».

   Remarque

   Dans ce cas, le bouton « Exécuter » exécute le script CREATE PROCEDURE et agit comme mécanisme d’enregistrement pour la procédure stockée.

   

Modifier une procédure stockée existante

Le Gestionnaire de bases de données vous permet de modifier une procédure stockée après sa création. Nous allons vous montrer comment modifier une procédure stockée à l’aide de notre exemple précédent à partir de «Créer une procédure stockée». Nous allons ajouter un paramètre supplémentaire à la procédure stockée « GetUserResources ». Pour modifier une procédure stockée :

1. Ouvrez Gestionnaire des services Internet (IIS) .

2. Accédez au Gestionnaire de bases de données et développez votre nœud de connexion de base de données (pour plus d’informations sur la création de connexions à une base de données, consultez Les bases du Gestionnaire de base de données IIS).

3. Développez le nœud Procédures stockées. Vous devez maintenant voir une liste de toutes vos procédures stockées de base de données, notamment « GetUserResources ».

4. Sélectionnez la procédure stockée « GetUserResources ».

5. Dans la barre d’outils du Gestionnaire de bases de données, sélectionnez « Script as ALTER ». Un éditeur de requête s’ouvre et est prérempli avec le modèle ALTER PROCEDURE nécessaire pour modifier une procédure stockée.
   

6. Sous le paramètre « @Username », ajoutez un paramètre supplémentaire à l’aide du texte suivant :

   @Username VARCHAR(50), @IsUserAllowed BIT
   

   Remarque

   N’oubliez pas d’ajouter la virgule après la première variable.

7. Dans le corps de la procédure stockée, entre BEGIN et END, modifiez la requête comme suit :

   SELECT FabrikamUsers.Username, AccessControls.ResourceURL, AccessControls.IsUserAllowed
   FROM FabrikamUsers
   INNER JOIN AccessControls ON (FabrikamUsers.UserId = AccessControls.UserId)
   WHERE FabrikamUsers.Username = @Username 
   AND AccessControls.IsUserAllowed = @IsUserAllowed
   

   

8. Cliquez sur « Exécuter » dans la barre d’outils de l’éditeur de requête. La procédure stockée sera maintenant modifiée.

   Remarque

   Dans ce cas, le bouton « Exécuter » exécute le script ALTER PROCEDURE et agit comme mécanisme d’enregistrement pour les modifications de la procédure stockée.

9. Vous pouvez continuer à apporter d’autres modifications dans l’éditeur ou fermer l’éditeur.

Créer une nouvelle procédure stockée basée sur une procédure existante

Le Gestionnaire de bases de données vous permet de créer une procédure stockée basée sur le code d’un système existant. Cette fonctionnalité peut être comparée à un « Enregistrer sous ... » action pour les procédures stockées. Pour créer une procédure stockée basée sur une procédure existante :

1. Ouvrez Gestionnaire des services Internet (IIS) .

2. Accédez au Gestionnaire de bases de données et développez votre nœud de connexion de base de données (pour plus d’informations sur la création de connexions à une base de données, consultez Les bases du Gestionnaire de base de données IIS).

3. Développez le nœud Procédures stockées. Vous devez maintenant voir une liste de toutes vos procédures stockées de base de données.

4. Sélectionnez la procédure stockée existante sur laquelle vous souhaitez baser votre nouvelle procédure.

5. Dans la barre d’outils du Gestionnaire de bases de données, cliquez sur « Script as CREATE ». L’éditeur de requête s’ouvre et est prérempli avec une procédure stockée CREATE avec la même signature et le même corps que celui existant.
   

6. Renommez la procédure en modifiant le nom après CREATE PROCEDURE sur la première ligne.
   

7. Apportez des modifications à la procédure stockée, puis cliquez sur « Exécuter ». La nouvelle procédure stockée est créée et vous pouvez confirmer qu’elle apparaît sous le nœud « Procédures stockées ».

   Remarque

   Si vous ne modifiez pas le nom de la procédure stockée, vous ne pourrez pas exécuter l’instruction.

Exécution d’une procédure stockée

Le Gestionnaire de bases de données vous permet d’exécuter des procédures stockées. Par exemple, nous allons exécuter la procédure stockée « GetUserResources » et afficher les résultats. Pour exécuter une procédure stockée:

1. Ouvrez Gestionnaire des services Internet (IIS) .
2. Accédez au Gestionnaire de bases de données et développez votre nœud de connexion de base de données (pour plus d’informations sur la création de connexions à une base de données, consultez Les bases du Gestionnaire de base de données IIS).
3. Développez le nœud Procédures stockées. Vous devez maintenant voir une liste de toutes vos vues de base de données, notamment « GetUserResources ».
4. Sélectionnez la procédure stockée « GetUserResources ».
5. Dans la barre d’outils du Gestionnaire de bases de données, sélectionnez « Exécuter la procédure stockée ». Une boîte de dialogue s’ouvre et demande les paramètres de procédure stockée.
   
6. Entrez les paramètres de l’appel de procédure stockée, puis cliquez sur « OK » pour fermer la boîte de dialogue. Pour « GetUserResources », vous devez entrer une valeur VARCHAR pour le nom d’utilisateur et une valeur booléenne pour le paramètre IsUserAllowed.
   
7. Une fenêtre d’éditeur de requête s’ouvre et est préremplie avec l’instruction EXEC utilisée pour appeler la procédure stockée. Le volet inférieur contient les résultats retournés par la procédure stockée.
   
8. Vous pouvez modifier les valeurs des arguments dans l’éditeur et réexécuter la requête.

Supprimer une procédure stockée existante

Le Gestionnaire de bases de données vous permet de supprimer une procédure stockée existante. Supprimer une procédure stockée:

1. Ouvrez Gestionnaire des services Internet (IIS) .
2. Accédez au Gestionnaire de bases de données et développez votre nœud de connexion de base de données (pour plus d’informations sur la création de connexions à une base de données, consultez Les bases du Gestionnaire de base de données IIS).
3. Développez le nœud Procédures stockées. Vous devez maintenant voir une liste de toutes vos procédures stockées de base de données.
4. Sélectionnez la procédure stockée que vous souhaitez supprimer.
5. Cliquez avec le bouton droit et sélectionnez Supprimer. Vous êtes invité à confirmer l’opération.
   
6. Si vous choisissez « Oui », la procédure stockée est supprimée. Vous pouvez confirmer que la procédure stockée est supprimée en inspectant la liste des procédures stockées sous le nœud « Procédures stockées ».