Partager via

Vue d'ensemble des résultats de requête

  • Article

Une fois que vous avez ouvert ou créé une requête de base de données dans l'éditeur Transact-SQL, vous exécutez en général cette requête et examinez les résultats.Lorsque vous exécutez une requête, l'éditeur utilise le volet Résultats pour communiquer les résultats de cette requête.Le volet Résultats contient un maximum de cinq onglets : Résultats, Messages, Statistiques du client et Plan d'exécution.Les onglets spécifiques qui s'affichent dépendent des facteurs suivants.

  • Afficher le paramètre de résultats : choisissez d'afficher les résultats à l'aide des trois méthodes suivantes : Résultats sous forme de grille (valeur par défaut), Résultats sous forme de texte ou Résultats dans un fichier.De cette manière, vous déterminez si l'onglet Résultats, l'onglet Messages ou les deux sont utilisés pour communiquer les résultats.

  • Paramètre des statistiques du client : si vous activez le paramètre Inclure les statistiques du client, l'onglet Statistiques du client sera utilisé pour afficher des statistiques.

  • Paramètre Plan d'exécution : si vous cliquez sur Afficher le plan d'exécution estimé ou activez le paramètre Inclure le plan d'exécution réel, l'onglet Plan d'exécution est utilisé pour afficher un plan d'exécution.

Vous pouvez redimensionner le volet Résultats en utilisant la barre de fractionnement au bord de la fenêtre.

Onglet Résultats

Si vous choisissez d'afficher des résultats sous la forme d'une grille, l'onglet Résultats affiche les données que votre requête a récupérées de la base de données.Les données contiennent un ou plusieurs jeux indépendants de résultats.Seules les requêtes qui retournent des résultats, telles qu'une requête qui contient une instruction SELECT ou une procédure stockée, affichent des données sous l'onglet Résultats.Si une requête est exécutée correctement mais qu'aucun jeu de résultats n'est retourné, l'onglet Résultats n'apparaît pas.

Si vous choisissez d'afficher des résultats sous la forme de texte, tous les résultats et messages apparaissent sous l'onglet Résultats, et l'onglet Messages n'apparaît pas.Si vous choisissez d'enregistrer vos résultats dans un fichier, vous êtes invité à entrer le nom du fichier où seront enregistrés vos résultats.Les messages apparaissent sous l'onglet Messages.

Les résultats de la commande Valider la syntaxe SQL apparaissent toujours sous l'onglet Résultats.

Vous pouvez effectuer les actions suivantes lorsque vous cliquez avec le bouton droit sur l'onglet Résultats :

  • Copier
    Copie les données sélectionnées (une cellule ou une plage de cellules) vers le Presse-papiers.

  • Sélectionner tout
    Sélectionne toutes les lignes et colonnes dans la liste de résultats.Vous effectuez en général cette action avant de copier des données.

  • Enregistrer les résultats sous
    Enregistre le contenu de l'onglet Résultats dans un fichier .CSV que vous spécifiez.Les résultats seront enregistrés dans un fichier .TXT si vous choisissez d'afficher des résultats sous la forme de texte.

  • Fenêtre Propriétés
    Affiche la fenêtre Propriétés.

Jeux de résultats multiples

Si vous exécutez un jeu d'instructions Transact-SQL qui produisent plusieurs jeux de résultats, les jeux apparaissent sous l'onglet Résultats, séparés par des barres de fractionnement.Vous pouvez redimensionner des jeux de résultats individuels à l'aide des barres de fractionnement, et vous pouvez appuyer sur F6 et MAJ+F6 pour naviguer entre les résultats et les volets.

Onglet Messages

L'onglet Messages affiche tous les messages que le serveur de base de données retourne lorsque vous exécutez les requêtes.Ces messages incluent la sortie de texte, par exemple les résultats d'une instruction PRINT.L'onglet Messages inclut également des messages personnalisés, notamment lorsque vous exécutez un lot à l'aide de "GO 10".Les requêtes qui ne récupèrent pas de données, telles que les requêtes de mise à jour, affichent également un message sous l'onglet Messages.

Les messages de réussite et d'échec apparaissent sous cet onglet, dans l'ordre de leur retour par le serveur.Si vous choisissez d'afficher des résultats sous la forme de texte, le contenu de l'onglet Messages apparaît à la place sous l'onglet Résultats.

Vous pouvez effectuer les actions suivantes lorsque vous cliquez avec le bouton droit sur l'onglet Messages :

  • Copier
    Copie le texte sélectionné dans le Presse-papiers.

  • Sélectionner tout
    Sélectionne tous les messages.Vous effectuez en général cette action avant de copier des messages.

  • Enregistrer les résultats sous
    Enregistre le contenu de l'onglet Messages dans un fichier .TXT que vous spécifiez.

  • Fenêtre Propriétés
    Affiche la fenêtre Propriétés.

Onglet Statistiques du client

L'onglet Statistiques du client contient les informations relatives à chaque exécution d'une requête dans cette instance de l'éditeur Transact-SQL (même s'il s'agit d'une requête différente).Une colonne est ajoutée à chaque fois que vous exécutez la requête, et les moyennes sont mises à jour.Chaque cellule indique non seulement la valeur pour cette exécution mais également si cette valeur a changé.Les augmentations sont indiquées par une flèche ascendante et les diminutions par une flèche descendante, et l'absence de modification de la valeur pour l'exécution précédente est indiquée par une flèche droite.

Notes

Chaque exécution ajoute une colonne à droite de la colonne Statistique et à gauche des colonnes pour les exécutions précédentes.

Pour la première exécution, tous les résultats sont marqués sans modification.Chaque colonne est étiquetée avec l'heure d'exécution de la requête.Les colonnes sont ajoutées sur le côté gauche.

L'onglet Statistiques du client apparaît uniquement si vous avez choisi d'inclure les statistiques du client lors de l'exécution vos requêtes.Pour plus d'informations, consultez Procédure : contrôler le rassemblement et l'affichage des statistiques du client.

Vous pouvez effectuer les actions suivantes lorsque vous cliquez avec le bouton droit sur l'onglet Statistiques du client :

  • Copier
    Copie les lignes sélectionnées dans le Presse-papiers.

  • Sélectionner tout
    Sélectionne toutes les lignes.Vous effectuez en général cette action avant de copier des lignes.

  • Fenêtre Propriétés
    Affiche la fenêtre Propriétés.

Statistiques disponibles

Les statistiques suivantes sont disponibles sous l'onglet Statistiques du client :

  • Nombre d'instructions INSERT, DELETE et UPDATE
    Nombre d'instructions INSERT, DELETE ou UPDATE exécutées suite à votre requête.

  • Lignes affectées par les instructions INSERT, DELETE et UPDATE
    Nombre de lignes affectées par les instructions INSERT, DELETE ou UPDATE exécutées dans le cadre de votre requête.

  • Nombre d'instructions SELECT
    Nombre d'instructions SELECT exécutées via la connexion dans le cadre de votre exécution de la requête.Ce nombre inclut les instructions FETCH pour extraire les lignes des curseurs.

  • Lignes retournées par les instructions SELECT
    Nombre de lignes sélectionnées dans le cadre de votre exécution de la requête.Ce nombre reflète toutes les lignes générées par les instructions Transact-SQL, y compris celles qui n'ont pas été consommées réellement par l'appelant (par exemple, si vous annulez l'exécution).Ce nombre inclut aussi les instructions FETCH pour extraire les lignes des curseurs.

  • Nombre de transactions
    Nombre des transactions utilisateur démarrées dans le cadre de votre exécution de la requête, notamment les restaurations.

  • Nombre d'allers-retours serveur
    Le nombre de fois que la connexion a envoyé des commandes au serveur et a reçu une réponse dans le cadre de l'exécution de la requête.

  • Paquets TDS envoyés depuis le client
    Nombre des paquets TDS que le client a envoyés au serveur de base de données pendant l'exécution de la requête.Les commandes longues peuvent nécessiter plusieurs tampons.Par exemple, si une commande importante est envoyée au serveur et requiert six paquets, le nombre d'allers-retours serveur est incrémenté de un, et le nombre des paquets TDS envoyés par le client est incrémenté de six.

  • Paquets TDS reçus du serveur
    Nombre des paquets TDS que le client a reçus de l'instance de SQL Server.

  • Octets envoyés du client
    Nombre d'octets envoyés par le client à l'instance de SQL Server pendant l'exécution de la requête.

  • Octets reçus du serveur
    Nombre d'octets que le client a reçu de l'instance de SQL Server pendant l'exécution de la requête.

  • Durée de traitement du client
    Durée cumulative consacrée par le client à l'exécution du code pendant l'exécution de la requête.

  • Durée d'exécution totale
    Durée cumulative (en millisecondes) consacrée par le client au traitement durant l'exécution de la requête, notamment le temps consacré par le client à l'attente des réponses du serveur ainsi que le temps passé à exécuter le code.

  • Temps d'attente pour les réponses du serveur
    Durée cumulative (en millisecondes) consacrée par le client à attendre les réponses du serveur.

Onglet Plan d'exécution

L'onglet Plan d'exécution affiche le plan d'exécution estimé ou réel pour les requêtes sélectionnées.Lors de la génération des plans d'exécution estimés, les traitements ou requêtes Transact-SQL ne sont pas exécutés.En revanche, le plan d'exécution généré affiche le plan d'exécution de requête que l'instance de SQL Server utiliserait probablement si les requêtes étaient réellement exécutées.

Une connexion à une instance de SQL Server est obligatoire pour afficher le plan d'exécution estimé ou réel.Pour accéder au menu qui contient les boutons Afficher le plan d'exécution estimé ou Inclure le plan d'exécution réel, cliquez avec le bouton droit sur la fenêtre de l'éditeur Transact-SQL ou cliquez sur Données, puis sur Éditeur Transact-SQL.Pour consulter le plan d'exécution réel, vous devez également exécuter votre requête ou lot.

Pour afficher des informations supplémentaires, placez le curseur sur les icônes des opérateurs logiques et physiques, et consultez la description et les propriétés de l'opérateur indiquées dans l'info-bulle.Il est également possible d'afficher les propriétés des opérateurs dans la fenêtre Propriétés.Si la fenêtre Propriétés n'est pas visible, cliquez avec le bouton droit sur un opérateur, puis cliquez sur Fenêtre Propriétés.Sélectionnez l'opérateur pour afficher ses propriétés.

Pour utiliser cette fonctionnalité, les utilisateurs doivent disposer des autorisations adéquates pour exécuter la requête Transact-SQL correspondant au plan d'exécution graphique à générer, et ils doivent posséder l'autorisation SHOWPLAN pour toutes les bases de données référencées par la requête.Pour plus d'informations, consultez Showplan.

Vous pouvez effectuer les actions suivantes lorsque vous cliquez avec le bouton droit sur l'onglet Plan d'exécution :

  • Enregistrer les résultats sous
    Enregistre le contenu de l'onglet Plan d'exécution dans un fichier plan d'exécution (.sqlplan) que vous spécifiez.

  • Fenêtre Propriétés
    Affiche la fenêtre Propriétés.

Voir aussi

Tâches

Procédure : exécuter une requête

Référence

Options de l'Éditeur Transact-SQL (Exécution de requête/Général)

Concepts

Modification des scripts et des objets de base de données avec l'Éditeur Transact-SQL