Fenêtre Éditeur de requête du moteur de base de données SQL Server Management Studio

Obtenir l'aide Transact-SQL

Cette rubrique est l'emplacement par défaut de l'aide F1 depuis la fenêtre de l'éditeur de requête du moteur de base de données. Cela signifie que si vous appuyez sur F1 après avoir mis en surbrillance, dans l'éditeur, du texte ne correspondant pas à un mot clé d'aide F1 associé à l'une des rubriques de référence Transact-SQL, l'aide F1 affichera cette rubrique. Dans ce cas, il existe deux moyens d'obtenir de l'aide supplémentaire :

• Copiez et collez le texte que vous avez mis en surbrillance dans l'onglet de recherche de la Documentation en ligne de SQL Server et lancez une recherche.

• Mettez en surbrillance uniquement la partie de l'instruction Transact-SQL susceptible de correspondre à un mot clé F1 associé à une rubrique et appuyez de nouveau sur F1. Voici quelques exemples de chaînes à mettre en surbrillance :

  • Le nom d'une instruction Transact-SQL, telle que CREATE DATABASE ou BEGIN TRANSACTION.

  • Le nom d'une fonction intégrée, telle que SERVERPROPERTY ou @@VERSION.

  • Le nom d'une table de procédures stockées système ou d'une vue, telle que sys.data_spaces ou sp_tableoption.

Fonctionnalités

• Tapez vos scripts dans la fenêtre de l'éditeur de requête.

• Pour exécuter les scripts, appuyez sur F5 ; ou cliquez sur Exécuter dans la barre d'outils ; ou dans le menu Requête, cliquez sur Exécuter. Si une partie du code est sélectionnée, seule celle-ci est exécutée. Si aucune partie du code n'est sélectionnée, l'ensemble du code contenu dans l'éditeur de requête est exécuté.

• Pour obtenir de l'aide sur la syntaxe Transact-SQL, sélectionnez un mot clé dans l'éditeur de requête, puis cliquez sur F1.

• Pour obtenir une aide dynamique sur la syntaxe Transact-SQL, dans le menu Aide, cliquez sur Aide dynamique pour ouvrir le composant Aide dynamique. Avec l'aide dynamique, les rubriques d'aide s'affichent dans la fenêtre Aide dynamique lorsque des mots clés sont tapés dans l'éditeur de requête.

• L'éditeur de requête prend en charge les fonctionnalités d'IntelliSense, telles que la saisie semi-automatique des mots et des paramètres. Pour plus d'informations, consultez Utilisation de la fonctionnalité IntelliSense.

  Notes

  L'activation d'IntelliSense pour les scripts Transact-SQL volumineux peut réduire les performances des ordinateurs lents. Pour plus d'informations sur la façon de limiter la taille des scripts Transact-SQL pour lesquels IntelliSense est activé, consultez Options (Éditeur de texte/Transact-SQL/IntelliSense).

• L'éditeur de requête s'accompagne du débogueur Transact-SQL que vous pouvez utiliser pour déboguer avec plus de facilité les scripts et les instructions Transact-SQL. Pour plus d'informations, consultez Utilisation du débogueur Transact-SQL.

• Les messages d'erreur s'affichent dans les zones suivantes :

  • Dans un onglet Messages au bas de la fenêtre dans le cas des erreurs retournées par le Moteur de base de données SQL Server.

  • Dans la fenêtre Liste d'erreurs dans le cas des erreurs générées par IntelliSense. Pour plus d'informations, consultez Fenêtre Liste d'erreurs (Management Studio).

  • Dans les fenêtres Sortie ou Immédiat dans le cas des erreurs générées par le débogueur Transact-SQL.

Barre d'outils Éditeur SQL

Lorsque vous ouvrez l'éditeur de requête du Moteur de base de données, la barre d'outils Éditeur SQL s'affiche avec les boutons suivants :

• Se connecter
  Ouvre la boîte de dialogue Se connecter au serveur. Utilisez cette boîte de dialogue pour établir une connexion à un serveur.

• Déconnecter
  Déconnecte l'éditeur de requête actuel du serveur.

• Modifier la connexion
  Ouvre la boîte de dialogue Se connecter au serveur. Utilisez cette boîte de dialogue pour établir une connexion à un serveur différent.

• Nouvelle requête avec la connexion actuelle
  Ouvre une nouvelle fenêtre de l'éditeur de requête et utilise les informations de connexion de la fenêtre actuelle de l'éditeur de requête.

• Bases de données disponibles
  Permet de se connecter à une autre base de données sur le même serveur.

• Exécuter
  Exécute le code sélectionné ou, si aucun code n'est sélectionné, exécute la totalité du code figurant dans l'éditeur de requête.

• Déboguer
  Active le débogueur Transact-SQL. Ce débogueur prend en charge les actions de débogage comme la définition de points d'arrêt, la surveillance de variables et l'exécution pas à pas du code.

• Annuler l'exécution de la requête
  Envoie une demande d'annulation au serveur. Certaines requêtes ne peuvent pas être annulées immédiatement et doivent attendre une condition d'annulation appropriée. Les opérations de restauration de transactions peuvent prendre un certain temps lorsque celles-ci sont annulées.

• Analyser
  Vérifie la syntaxe du code sélectionné. Si aucun code n'est sélectionné, cette option vérifie la syntaxe de l'ensemble du code contenu dans la fenêtre de l'éditeur de requête.

• Afficher le plan d'exécution estimé
  Demande un plan d'exécution de la requête au processeur de requêtes sans exécuter la requête et affiche le plan dans la fenêtre Plan d'exécution. Ce plan utilise les statistiques d'index pour estimer le nombre de lignes qui seront renvoyées pendant chaque partie de l'exécution de la requête. Le plan de requête utilisé dans la pratique peut être différent du plan d'exécution estimé. Cela peut se produire si le nombre de lignes renvoyées diffère sensiblement de l'estimation. À ce moment-là, le processeur de requêtes modifie le plan pour qu'il soit plus efficace.

• Options de requête
  Ouvre la boîte de dialogue Options de requête. Utilisez cette boîte de dialogue pour configurer les options par défaut d'exécution des requêtes et d'affichage de leurs résultats.

• IntelliSense activé
  Indique si les fonctionnalités IntelliSense sont disponibles dans l'éditeur de requête du Moteur de base de données.

• Inclure le plan d'exécution réel
  Exécute la requête, puis renvoie les résultats de la requête et le plan d'exécution utilisé pour la requête. Ceux-ci s'affichent sous forme de plan de requête graphique dans la fenêtre Plan d'exécution.

• Inclure les statistiques du client
  Insère une fenêtre Statistiques du client qui contient des statistiques sur la requête et les paquets réseau, ainsi que le temps écoulé depuis le début de la requête.

• Résultats dans du texte
  Renvoie les résultats de la requête dans la fenêtre Résultats sous forme de texte.

• Résultats dans des grilles
  Renvoie les résultats de la requête dans la fenêtre Résultats sous forme d'une ou plusieurs grilles.

• Résultats dans un fichier
  Lors de l'exécution de la requête, la boîte de dialogue Enregistrer les résultats s'ouvre. Dans Enregistrer dans, sélectionnez le dossier dans lequel vous souhaitez enregistrer le fichier. Dans Nom de fichier, tapez le nom du fichier, puis cliquez sur Enregistrer pour enregistrer les résultats de la requête en tant que fichier de Rapport avec une extension .rpt. Pour des options avancées, cliquez sur la flèche de déroulement du bouton Enregistrer, puis cliquez sur Enregistrer avec l'encodage.

• Commenter la sélection
  Transforme la ligne active en commentaire en ajoutant un opérateur de commentaire (--) en début de ligne.

• Supprimer les marques de commentaire de la sélection
  Transforme la ligne active en instruction source active en supprimant l'opérateur de commentaire (--) en début de ligne.

• Réduire le retrait de ligne
  Déplace le texte de la ligne à gauche en supprimant les espaces en début de ligne.

• Augmenter le retrait de ligne
  Déplace le texte de la ligne vers la droite en ajoutant des espaces en début de ligne.

• Spécifier les valeurs des paramètres du modèle
  Ouvre une boîte de dialogue qui vous permet de spécifier les valeurs des paramètres des procédures stockées et des fonctions.

Vous pouvez également ajouter la barre d'outils Éditeur SQL en sélectionnant le menu Affichage, Barres d'outils, puis Éditeur SQL. Si vous ajoutez la barre d'outils Éditeur SQL alors qu'aucune fenêtre de l'éditeur de requête du Moteur de base de données n'est ouverte, tous les boutons sont indisponibles.

Barre d'outils Éditeur SQL

Lorsqu'une fenêtre de l'éditeur de requête du Moteur de base de données est ouverte, vous pouvez ajouter la barre d'outils Déboguer en sélectionnant successivement le menu Affichage, Barres d'outils et Déboguer. Si vous ajoutez la barre d'outils Déboguer alors qu'aucune fenêtre de l'éditeur de requête du Moteur de base de données n'est ouverte, tous les boutons sont indisponibles.

• Continuer
  Exécute le code contenu dans la fenêtre de l'éditeur de requête du Moteur de base de données jusqu'à ce qu'un point d'arrêt soit rencontré. 

• Interrompre tout
  Le débogueur interrompt tous les processus auxquels il est associé lorsqu'un arrêt se produit.

• Arrêter le débogage
  Sort la fenêtre de l'éditeur de requête du Moteur de base de données du mode débogage et rétablit le mode d'exécution standard.

• Afficher l'instruction suivante
  Déplace le curseur jusqu'à la prochaine instruction à exécuter.

• Pas à pas détaillé
  Exécute l'instruction qui suit l'instruction actuelle. Si l'instruction suivante appelle une procédure stockée Transact-SQL, une fonction ou un déclencheur, le débogueur affiche une nouvelle fenêtre de l'Éditeur de requête contenant le code du module. La fenêtre est en mode débogage, et l'exécution est suspendue à 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.

• Pas à pas principal
  Exécute l'instruction qui suit l'instruction actuelle. Si l'instruction appelle une procédure stockée Transact-SQL, une fonction ou un déclencheur, le module s'exécute jusqu'à ce qu'il se termine, et les résultats sont retournés au code appelant. Si vous êtes certain qu'un module ne comporte aucune erreur, vous pouvez passer à la tâche suivante. L'exécution est suspendue au niveau de l'instruction qui suit l'appel au module.

• Pas à pas sortant
  Retourne au niveau d'appel supérieur suivant (fonction, procédure stockée ou déclencheur). L'exécution est suspendue au niveau de l'instruction qui suit l'appel au module.

• Windows
  Ouvre la fenêtre Point d'arrêt ou la fenêtre Exécution.

Voir aussi

Référence

Concepts

Autres ressources

Historique des modifications