Débogueur Transact-SQL

Article
05/30/2023

S’applique à :SQL Server

Le débogueur Transact-SQL vous permet de détecter les erreurs dans le code Transact-SQL en étudiant le comportement du code au moment de l’exécution. Après avoir défini la fenêtre de l’éditeur de requête du Moteur de base de données en mode débogage, vous pouvez suspendre l’exécution du code au niveau de lignes spécifiques et inspecter les informations et les données qui sont utilisées ou retournées par ces instructions Transact-SQL.

Cette fonctionnalité fonctionne avec SSMS version 17.9.1 et antérieure. Le débogage T-SQL est également disponible dans SQL Server Data Tools pour Visual Studio.

Exécution pas à pas du code Transact-SQL

Les options suivantes fournies par le débogueur Transact-SQL vous permettent de parcourir le code Transact-SQL quand la fenêtre de l’éditeur de requête du Moteur de base de données est en mode débogage :

Définir des points d’arrêt sur des instructions Transact-SQL individuelles.

Un point d'arrêt spécifie un point auquel vous voulez interrompre l'exécution afin de pouvoir examiner les données. Lorsque vous démarrez le débogueur, celui-ci s'arrête à la première ligne de code dans la fenêtre de l'éditeur de requête. Pour exécuter le code jusqu’au premier point d’arrêt que vous avez défini, vous pouvez utiliser la fonctionnalité Continuer . Vous pouvez également utiliser la fonctionnalité Continuer pour exécuter le code à partir de l’emplacement où la fenêtre est actuellement arrêtée, quel qu’il soit, jusqu’au prochain point d’arrêt. Vous pouvez modifier les points d’arrêt pour spécifier des actions telles que les conditions dans lesquelles l’exécution doit être interrompue, les informations à imprimer dans la fenêtre Sortie , de même que vous pouvez modifier l’emplacement des points d’arrêt.
Effectuer un pas à pas détaillé dans l'instruction suivante.

Cette option vous permet de parcourir un jeu d'instructions une par une et d'observer leur comportement au fur et à mesure que vous avancez.
Effectuer un pas à pas détaillé ou principal dans un appel à une procédure stockée ou fonction.

Si vous êtes certain qu’une procédure stockée ne comporte aucune erreur, vous pouvez faire un pas à pas principal. La procédure est exécutée en entier, et les résultats sont retournés au code.

Si vous souhaitez déboguer une procédure stockée ou une fonction, vous pouvez effectuer un pas à pas détaillé dans le module. SQL Server Management Studio ouvre une nouvelle fenêtre de l’éditeur de requête du Moteur de base de données remplie avec le code source pour le module, place la fenêtre en mode débogage, puis suspend l’exécution à la première instruction dans le module. Vous pouvez ensuite parcourir le code du module, en définissant par exemple des points d'arrêt ou en exécutant le code pas à pas.

Pour plus d’informations sur les différentes façons dont vous pouvez parcourir le code avec le débogueur, consultez Exécuter pas à pas du code Transact-SQL.

Affichage des informations du débogueur

Chaque fois que le débogueur suspend l’exécution du code à une instruction Transact-SQL spécifique, vous pouvez utiliser les fenêtres suivantes du débogueur pour afficher l’état d’exécution actuel :

Variables locales et Espion. Ces fenêtres affichent les expressions Transact-SQL actuellement allouées. Les expressions sont des clauses Transact-SQL qui ont pour valeur une expression scalaire unique. Le débogueur Transact-SQL prend en charge l’affichage d’expressions qui font référence à des variables et à des paramètres Transact-SQL, ou les fonctions intégrées dont le nom commence par @@. Ces fenêtres affichent également les valeurs de données qui sont actuellement attribuées aux expressions.
Espion express. Cette fenêtre affiche la valeur d’une expression Transact-SQL et vous permet d’enregistrer cette expression dans une fenêtre Espion.
Points d’arrêt. Cette fenêtre affiche les points d'arrêt actuellement définis et vous permet de les gérer.
Pile des appels. Cette fenêtre affiche l'emplacement d'exécution actuel. Elle fournit également 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 de requête d'origine via des fonctions, des procédures stockées ou des déclencheurs.
Sortie : Cette fenêtre affiche divers messages et données du programme, notamment des messages système du débogueur.
Résultats et Messages. Ces onglets de la fenêtre de l’éditeur de requête affichent les résultats des instructions Transact-SQL exécutées précédemment.

Tâches du débogueur Transact-SQL

Description de la tâche	Rubrique
Décrit comment configurer le débogueur Transact-SQL pour le débogage distant.	Configurer des règles de pare-feu avant d’exécuter le débogueur T-SQL
décrit comment démarrer, arrêter et contrôler l'opération de débogage.	Exécuter le débogueur Transact-SQL
Décrit comment utiliser le débogueur Transact-SQL pour parcourir le code.	Exécuter pas à pas du code Transact-SQL
Décrit comment utiliser le débogueur pour afficher des données Transact-SQL (comme des paramètres et des variables) et des informations système.	Informations du débogueur Transact-SQL

Voir aussi

Éditeurs de texte et de requête (SQL Server Management Studio)