Éditeur de requêtes SQL Server Management Studio (SSMS)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Cet article explique les fonctionnalités et fonctions de l’éditeur de requête dans SQL Server Management Studio (SSMS).

Notes

Si vous souhaitez savoir comment utiliser l’aide de Transact-SQL (T-SQL) avec F1, consultez la section Aide sur Transact-SQL via la touche F1.

Si vous souhaitez en savoir plus sur les tâches que vous pouvez effectuer avec l’éditeur, consultez la section Tâches de l'éditeur.

Les éditeurs dans SSMS partagent une architecture classique. L'éditeur de texte implémente le niveau de base des fonctionnalités, et peut être utilisé comme éditeur de base pour les fichiers texte. Les autres éditeurs, ou éditeurs de requête, étendent cette base de fonctionnalité en incluant un service de langage qui définit la syntaxe d'un des langages pris en charge dans SQL Server. Les éditeurs de requête implémentent également différents niveaux de prise en charge des fonctionnalités de l'éditeur comme IntelliSense et le débogage. Les éditeurs de requête incluent l'éditeur de requête du moteur de base de données à utiliser dans l'élaboration de scripts contenant des instructions T-SQL et XQuery, l'éditeur MDX pour le langage MDX, l'éditeur DMX pour le langage DMX et l'éditeur XML/A pour le langage XML for Analysis. Vous pouvez utiliser l’Éditeur de requête pour créer et exécuter des scripts contenant des instructions Transact-SQL.

Screenshot of New query.

Barre d’outils Éditeur SQL

Quand vous ouvrez l’Éditeur de requête, la barre d’outils Éditeur SQL, qui comporte les boutons suivants, s’affiche.

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 n’est ouverte, tous les boutons sont indisponibles.

Screenshot of Editor toolbar.

Connexion à l’aide de la barre d’outils Éditeur

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

Vous pouvez également vous connecter à votre base de données à l’aide du menu contextuel.

Modifier la connexion à l'aide de la barre d'outils de l'éditeur

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

Vous pouvez également changer de connexion à l’aide du menu contextuel.

Bases de données disponibles à l’aide de la barre d’outils de l’éditeur

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

Exécution à l’aide de la barre d’outils Éditeur

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

Vous pouvez également exécuter une requête en sélectionnant F5 ou dans le menu contextuel.

Annuler l'exécution de la requête à l'aide de la barre d'outils de l'éditeur

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.

Pour annuler une requête en cours d’exécution, vous pouvez également sélectionner Alt+Pause.

Analyse à l’aide de la barre d’outils Éditeur

Contrôle la syntaxe du code sélectionné. Si aucun code n’est sélectionné, vérifie la syntaxe de l’ensemble du code de la fenêtre de l’Éditeur de requête.

Pour vérifier le code dans l’Éditeur de requête, vous pouvez également sélectionner Ctrl+F5.

Affichage du plan d’exécution estimé à l’aide de la barre d’outils de l’éditeur

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é. Si le nombre de lignes renvoyées diffère sensiblement de l'estimation et que le processeur de requêtes modifie le plan pour qu'il soit plus efficace, cela peut se produire.

Vous pouvez également afficher un plan d’exécution estimé en sélectionnant Ctrl+L ou dans le menu contextuel.

Options de requête à l’aide de la barre d’outils de l’éditeur

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.

Vous pouvez également sélectionner Options de requête dans le menu contextuel.

IntelliSense activé à l’aide de la barre d’outils de l’éditeur

Indique si les fonctionnalités IntelliSense sont disponibles dans l'éditeur de requête du moteur de base de données. Cette option est définie par défaut.

Vous pouvez également sélectionner IntelliSense activé en sélectionnant Ctrl+B, puis Ctrl+I, ou dans le menu contextuel.

Inclure le plan d'exécution réel à l'aide de la barre d'outils de l'éditeur

Exécute la requête, puis renvoie les résultats de la requête et utilise le plan d'exécution pour la requête. Ces requêtes s’affichent sous forme de plan de requête graphique dans la fenêtre Plan d’exécution.

Vous pouvez également choisir Ajout du plan d’exécution réel en sélectionnant Ctrl+M ou dans le menu contextuel.

Inclure des statistiques sur les requêtes en direct à l'aide de la barre d'outils de l'éditeur

Fournit des insights en temps réel sur le processus d’exécution des requêtes à mesure que les contrôles passent d’un opérateur de plan de requête à un autre.

Vous pouvez également sélectionner Ajout des statistiques des requêtes actives dans le menu contextuel.

Inclure des statistiques sur les clients à l'aide de la barre d'outils de l'éditeur

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.

Vous pouvez également choisir Ajout des statistiques du client en sélectionnant Maj+Alt+S ou dans le menu contextuel.

Résultats dans un texte à l’aide de la barre d’outils de l’éditeur

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

Vous pouvez également retourner les résultats dans du texte en sélectionnant Ctrl+T ou dans le menu contextuel.

Résultats dans une grille à l’aide de la barre d’outils de l’éditeur

Retourne les résultats de la requête dans la fenêtre Résultats sous forme d’une ou plusieurs grilles. Cette option est activée par défaut.

Vous pouvez également retourner les résultats dans une grille en sélectionnant Ctrl+D ou dans le menu contextuel.

Résultats dans un fichier à l’aide de la barre d’outils de l’éditeur

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 sélectionnez Enregistrer pour enregistrer les résultats de la requête dans un fichier Rapport portant l’extension .rpt. Pour accéder aux options avancées, sélectionnez la flèche déroulante vers le bas qui se trouve sur le bouton Enregistrer, puis sélectionnez Enregistrer avec l’encodage.

Vous pouvez également retourner les résultats dans un fichier en sélectionnant Ctrl+Maj+F ou dans le menu contextuel.

Mise en commentaire des lignes sélectionnées à l’aide de la barre d’outils Éditeur

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

Pour mettre une ligne en commentaire, vous pouvez également sélectionner Ctrl+K, puis Ctrl+C.

Suppression de la marque de commentaire sur les lignes sélectionnées à l’aide de la barre d’outils Éditeur

Transforme la ligne active en instruction source active en supprimant l'opérateur de commentaire (--) en début de ligne.

Pour supprimer la marque de commentaire sur une ligne, vous pouvez également sélectionner Ctrl+K, puis Ctrl+U.

Diminution du retrait à l'aide de la barre d'outils de l'éditeur

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

Augmentation du retrait de ligne à l’aide de la barre d'outils de l'éditeur

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

Spécification des valeurs des paramètres du modèle à l’aide de la barre d’outils de l’éditeur

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.

Menu contextuel

Pour accéder au menu contextuel, cliquez avec le bouton droit n’importe où dans l’Éditeur de requête. Les options du menu contextuel sont similaires à celles de la barre d’outils Éditeur SQL. Le menu contextuel comporte les mêmes options que Connexion et Exécution, ainsi que d’autres options, comme Insertion d’un extrait de code et Entourage avec.

Screenshot of Options.

Insérez un extrait à l'aide du menu contextuel

Les extraits Transact-SQL sont des modèles que vous pouvez utiliser comme point de départ lorsque vous écrivez de nouvelles instructions Transact-SQL dans l'éditeur de requêtes.

Entourage avec à l’aide du menu contextuel

Un extrait de code d’entourage est un modèle pouvant servir de point de départ à l’insertion d’un ensemble d’instructions Transact-SQL dans un bloc BEGIN, IF ou WHILE.

Connexion à l’aide du menu contextuel

Screenshot of Connections available.

Il existe plus d’options Connexion dans le menu contextuel que dans la barre d’outils de SSMS.

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

  • Déconnexion : déconnecte l’Éditeur de requête actif du serveur.

  • Déconnexion de toutes les requêtes : déconnecte toutes les connexions de requête.

  • Changement de 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.

Ouvrir le serveur dans l'Explorateur d'objets à l'aide du menu contextuel

L'Explorateur d'objets fournit une interface utilisateur hiérarchique pour afficher et gérer les objets dans chaque instance de SQL Server. Le volet Détails de l'Explorateur d'objets présente une vue tabulaire des objets d'instance et la fonction de recherche d'objets spécifiques. Les fonctionnalités de l'Explorateur d'objets varient légèrement selon le type de serveur. Il contient toutefois des fonctionnalités de développement pour les bases de données et des fonctionnalités de gestion pour tous les types de serveurs.

Exécution à l’aide du menu contextuel

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.

Affichage du plan d’exécution estimé à l’aide du menu contextuel

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 de l'estimation. À ce moment-là, le processeur de requêtes modifie le plan pour qu'il soit plus efficace.

IntelliSense activé à l’aide du menu contextuel

Indique si les fonctionnalités IntelliSense sont disponibles dans l'éditeur de requête du moteur de base de données. Cette option est définie par défaut.

Suivre la requête dans SQL Server Profiler à l’aide du menu contextuel

SQL Server Profiler est une interface permettant de créer et de gérer les traces, ainsi que d’analyser et de relire les résultats de trace. Les événements sont enregistrés dans un fichier de trace, qui peut être analysé ou utilisé ultérieurement pour relire une série d’étapes spécifique lors de la tentative de diagnostic d’un problème.

Analyser la requête dans Assistant Paramétrage du moteur de base de données à l'aide du menu contextuel

L’Assistant Paramétrage du moteur de base de données Microsoft analyse les bases de données et émet des recommandations pour optimiser les performances des requêtes. Il permet de sélectionner et de créer un ensemble optimal d’index, de vues indexées ou de partitions de table sans avoir une compréhension approfondie de la structure de la base de données ou des mécanismes internes de SQL Server. Vous pouvez effectuer les tâches suivantes à l'aide de l'Assistant Paramétrage du moteur de base de données :

Conception d’une requête dans l’éditeur à l’aide du menu contextuel

Le Concepteur de requêtes et de vues s'affiche lorsque vous ouvrez la définition d'une vue, lorsque vous affichez les résultats d'une requête ou d'une vue, ou encore lorsque vous créez ou ouvrez une requête.

Inclure le plan d'exécution réel à l'aide du menu contextuel

Exécute la requête, puis renvoie les résultats de la requête et utilise le plan d'exécution pour la requête. Ces requêtes s’affichent sous forme de plan de requête graphique dans la fenêtre Plan d’exécution.

Inclure des statistiques de requête en direct à l'aide du menu contextuel

Fournit des insights en temps réel sur le processus d’exécution des requêtes à mesure que les contrôles passent d’un opérateur de plan de requête à un autre.

Inclure des statistiques sur les clients à l'aide du menu contextuel

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 à l’aide du menu contextuel

Screenshot of Results options.

Vous pouvez sélectionner l’option Résultats de votre choix dans le menu contextuel.

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

  • Résultats dans une grille : retourne les résultats de la requête sous forme d’une ou plusieurs grilles dans la fenêtre Résultats.

  • 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 sélectionnez Enregistrer pour enregistrer les résultats de la requête dans un fichier Rapport avec l’extension .rpt. Pour accéder aux options avancées, sélectionnez la flèche déroulante vers le bas qui se trouve sur le bouton Enregistrer, puis sélectionnez Enregistrer avec l’encodage.

Fenêtre Propriétés à l’aide du menu contextuel

La fenêtre Propriétés décrit l'état d'un élément dans SQL Server Management Studio, tel qu'une connexion ou un opérateur Showplan, et fournit des informations sur les objets de base de données tels que les tables, les vues et les concepteurs.

Vous utilisez également la fenêtre Propriétés pour afficher les propriétés de la connexion active. La plupart des propriétés sont en lecture seule dans la Fenêtre Propriétés, mais sont modifiables à d’autres endroits de Management Studio. Par exemple, la propriété Database d'une requête est en lecture seule dans la fenêtre Propriétés mais elle peut être modifiée dans la barre d'outils.

Options de requête à l’aide du menu contextuel

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.

Aide sur Transact-SQL via la touche F1

L’Éditeur de requête vous communique un lien vers la rubrique de référence d’une instruction Transact-SQL donnée lorsque vous sélectionnez F1. Pour ce faire, mettez en surbrillance le nom d'une instruction Transact-SQL, puis sélectionnez F1. Le moteur de recherche d’aide recherche alors une rubrique comportant un attribut d’aide F1 qui corresponde à la chaîne en surbrillance.

Si le moteur de recherche d'aide ne trouve pas d'article avec un mot-clé d'aide F1 qui corresponde exactement à la chaîne que vous avez surligné, cet article est affiché. Dans ce cas, il existe deux approches pour obtenir l’aide recherchée :

  • Copier et coller la chaîne de l'éditeur que vous avez sélectionnée dans l'onglet de recherche de la documentation en ligne de SQL Server et effectuer une recherche.

  • Surlignez uniquement la partie de l'instruction Transact-SQL susceptible de correspondre à un mot-clé d'aide F1 appliqué à un article et sélectionnez à nouveau F1. Le moteur de recherche nécessite une correspondance exacte entre la chaîne que vous avez mise en surbrillance et un mot-clé d'aide F1 attribué à un article. Si la chaîne en surbrillance contient des éléments propres à votre environnement, comme des noms de colonnes ou de paramètres, le moteur de recherche n’obtient pas de correspondance. Voici quelques exemples de chaînes à sélectionner :

    • Nom d’une instruction Transact-SQL, telle que SELECT, CREATE DATABASE, ou BEGIN TRANSACTION.

    • Nom d’une fonction intégrée, telle que SERVERPROPERTY, ou @@VERSION.

    • Nom d'une table de procédure stockée ou de vues, telle que sys.data_spaces ou sp_tableoption.

Tâches de l'éditeur

Description de la tâche Article
Décrit les différentes façons d'ouvrir les éditeurs dans SSMS. Ouvrir un éditeur (SQL Server Management Studio)
Configurez les options des différents éditeurs, tels que la numérotation des lignes et les options IntelliSense. Configurer des éditeurs (SQL Server Management Studio)
Comment gérer le mode d'affichage, tel que le retour automatique à la ligne, le fractionnement d'une fenêtre, ou les onglets. Gérer l'Éditeur et le mode d'affichage
Définir les options de mise en forme, telles que le texte masqué ou la mise en retrait. Gérer la mise en forme du code
Parcourir le texte dans une fenêtre d'éditeur à l'aide de fonctionnalités telles que la recherche incrémentielle ou Atteindre. Naviguer dans le code et le texte
Définir les options de codage en couleurs pour différentes classes de syntaxe, ce qui facilite la lecture des instructions complexes. Codage en couleurs dans les éditeurs de requête
Faire glisser le texte d'un emplacement dans un script et le placer à un nouvel emplacement. Glisser et déplacer du texte
Définir des signets afin de rechercher plus facilement les segments de code importants. Gérer les signets
Imprimer des scripts ou les résultats dans une fenêtre ou une grille. Imprimer le code et les résultats
Afficher et utiliser les fonctionnalités de base dans l'éditeur de requête MDX. Créer des scripts Analysis Services
Afficher et utiliser les fonctionnalités de base dans l'éditeur de requête DMX. Créer une requête DMX
Afficher et utiliser les fonctionnalités de base dans l'éditeur de requête XML/A. Éditeur XML (SQL Server Management Studio)
Utiliser les fonctionnalités sqlcmd dans l'éditeur de requête du moteur de base de données. Modifier des scripts SQLCMD à l’aide de l’Éditeur de requête
Comment utiliser des extraits de code dans l’éditeur de requête du moteur de base de données. Les extraits de code sont des modèles pour des instructions ou des blocs couramment utilisés, et peuvent être personnalisés ou étendus pour inclure les extraits de code spécifiques au site. Ajouter des extraits de code Transact-SQL
Guide pratique pour utiliser le débogueur Transact-SQL afin de parcourir le code et d’afficher les informations de débogage comme les valeurs des variables et des paramètres. Débogueur Transact-SQL