Débogueur Transact-SQL - Informations

S’applique à :SQL Server

Chaque fois que le débogueur suspend l'exécution du code au niveau d'une instruction Transact-SQL spécifique, vous pouvez utiliser les différentes fenêtres du débogueur pour afficher l'état d'exécution actuel.

Cette fonctionnalité fonctionne avec SSMS version 17.9.1 et antérieure.

Fenêtres du débogueur

En mode débogage, le débogueur ouvre deux fenêtres en bas de la fenêtre principale de SQL Server Management Studio. Le débogueur affiche toutes ses informations dans ces deux fenêtres. Chaque fenêtre du débogueur contient des onglets que vous pouvez sélectionner pour contrôler le jeu d'informations à afficher dans la fenêtre. La fenêtre gauche du débogueur contient les onglets Variables locales, Espion 1, Espion 2, Espion 3et Espion 4 . La fenêtre droite du débogueur contient les onglets Pile des appels, Threads, Points d’arrêt, Fenêtre de commandeet Sortie .

Par défaut, ces onglets ou fenêtres ne sont pas tous actifs. Vous pouvez ouvrir une fenêtre particulière en procédant de l'une des manières suivantes :

• Dans le menu Déboguer , cliquez sur Fenêtres, puis sélectionnez la fenêtre de votre choix.

• Dans la barre d’outils Déboguer , cliquez sur Points d’arrêt, puis sélectionnez la fenêtre désirée.

Expressions Transact-SQL

Les expressions sont des clauses Transact-SQL qui prennent une valeur scalaire unique, par exemple des variables ou des paramètres. La fenêtre gauche du débogueur peut afficher les valeurs de données qui sont actuellement affectées à des expressions dans cinq onglets ou fenêtres au maximum : Variables locales, Espion 1, Espion 2, Espion 3et Espion 4.

La fenêtre Variables locales affiche des informations sur les variables locales dans l’étendue actuelle du débogueur Transact-SQL. L’ensemble d’expressions répertorié dans la fenêtre Variables locales change à mesure que le débogueur exécute les différentes parties du code.

Les expressions figurant dans Espion Express et les quatre fenêtres Espion ne servent pas uniquement à indiquer l’identificateur d’une variable. Vous pouvez spécifier une expression Transact-SQL qui prend une valeur unique, comme l'ajout d'un nombre à une variable, ou une instruction SELECT qui prend une valeur unique. Voici quelques exemples :

• Nom d’une variable de type, comme @IntegerCounter.

• Opération arithmétique sur une variable, par exemple @IntegerCounter + 1.

• Opération de chaîne sur deux variables de caractères, par exemple @FirstName + @LastName.

• Une instruction SELECT qui retourne une seule valeur, par exemple SELECT CharCol FROM MyTable WHERE PrimaryKey = 1.

Vous pouvez utiliser la fenêtre Espion express pour afficher la valeur d’une expression Transact-SQL, puis enregistrer cette expression dans une fenêtre Espion. Pour sélectionner une expression dans la fenêtre Espion express, sélectionnez ou entrez le nom de l’expression dans la zone Expression .

Les quatre fenêtres Espion affichent des informations sur les variables et les expressions que vous avez sélectionnées. L’ensemble d’expressions répertorié dans la fenêtre Variables locales reste inchangé, sauf si vous modifiez ou supprimez des expressions dans la liste.

Pour ajouter une expression dans une fenêtre Espion , vous pouvez sélectionner Ajouter un espion dans la boîte de dialogue Espion express ou entrer le nom de l’expression dans la colonne Nom d’une ligne vide dans une fenêtre Espion .

Vous pouvez définir les valeurs de données pour des variables dans les fenêtres Variables locales, Espionou Espion express en cliquant avec le bouton droit sur la ligne, puis en sélectionnant Modifier la valeur. Les colonnes Valeur dans la fenêtre Variables locales , la fenêtre Espion et la boîte de dialogue Espion express prennent toutes en charge les visualiseurs de données texte, XML et HTML. Les visualiseurs sont représentés par une bulle d’informations en forme de loupe à droite de la colonne Valeurs . Vous pouvez utiliser les visualiseurs pour afficher des valeurs de données texte, XML ou HTML dans des affichages qui correspondent aux types de données, par exemple des fichiers XML dans une fenêtre de navigateur.

En mode débogage, lorsque vous déplacez le pointeur de la souris sur un identificateur, une fenêtre contextuelle Info express affiche le nom de l’expression et sa valeur actuelle. Pour plus d’informations, consultez Info express (IntelliSense).

Points d’arrêt

Vous pouvez utiliser la fenêtre Points d’arrêt pour afficher et gérer les points d’arrêt actuellement définis. Pour plus d’informations, consultez Exécuter pas à pas du code Transact-SQL.

Pile des appels

La fenêtre Pile des appels affiche l’emplacement d’exécution actuel et des informations sur la façon dont l’exécution a atteint l’emplacement d’exécution actuel à partir de la fenêtre de l’éditeur d’origine via des modules Transact-SQL (fonctions, procédures stockées ou déclencheurs). Chaque ligne dans la fenêtre Pile des appels est appelée un « frame de pile » et représente l’un des éléments suivants :

• l'emplacement d'exécution actuel ;

• un appel d'un module à un autre ;

• un appel d'une fenêtre d'éditeur à un module Transact-SQL.

La pile est ordonnée dans le sens inverse de l'appel des modules. L'emplacement d'exécution actuel se trouve en haut de la pile, et l'appel d'origine en bas. Une flèche jaune dans la marge gauche du frame de pile identifie le frame dans lequel le débogueur a suspendu l'exécution.

La colonne Nom enregistre les informations suivantes :

• le module source contenant la ligne de code ayant appelé le niveau suivant ;

• la ligne de code ayant appelé le module suivant dans la pile.

• Si l'appel est allé à une procédure stockée ou à une fonction ayant accepté des paramètres, les noms, types de données et valeurs de tous les paramètres sont également répertoriés.

Les expressions dans les fenêtres Variables locales, Espionet Espion express sont évaluées pour le frame de pile actuel. Par défaut, le frame de pile actuel est le premier frame de la pile, où le débogueur a suspendu l'exécution. Lorsque vous spécifiez un autre frame de pile en tant que frame actuel, les expressions dans les fenêtres Variables locales, Espionet Espion express sont réévaluées pour le nouveau frame de pile. Vous pouvez modifier le frame de pile actuel en double-cliquant sur un frame ou en cliquant sur un frame et en sélectionnant Basculer vers le frame. À ce stade, les expressions dans les fenêtres Variables locales, Espionet Espion express sont réévaluées pour le nouveau frame. Lorsque le frame de pile actuel n'est pas le premier frame de la pile, une flèche verte dans la marge gauche du frame de pile identifie le frame de pile actuel.

Lorsque vous cliquez avec le bouton droit sur un frame de pile et que vous sélectionnez Atteindre le code source, le code pour ce frame est affiché dans une fenêtre de l’éditeur de requête. Toutefois, ce frame ne devient pas le frame actuel, et le contenu des fenêtres Variables locales, Espionet Espion express n’est pas modifié.

Informations système et résultats Transact-SQL

Le débogueur répertorie son état et des messages d’événements dans la fenêtre Sortie . Ces informations indiquent notamment à quel moment le débogueur se joint à d'autres processus et à quel moment les threads du débogueur se terminent.

En mode débogage, les onglets Résultats et Messages sont toujours actifs dans l’éditeur de requête. L’onglet Résultats continue à afficher les jeux de résultats des instructions Transact-SQL qui sont exécutées au cours d’une session de débogage. L’onglet Messages continue à afficher des messages système, tels que xx lignes affectées et la sortie des instructions PRINT et RAISERROR.

Voir aussi

Variables locales (fenêtre)
Espion (fenêtre)
Fenêtre Points d'arrêt
Fenêtre Pile des appels
Fenêtre Threads
Fenêtre Sortie
Débogueur Transact-SQL