Partager via


Utiliser l’outil Recommandation de l’indicateur de requête (préversion)

L’outil Recommandation des indicateurs de requête aide les utilisateurs de SQL Server Management Studio (SSMS) à explorer les indicateurs de requête pour améliorer les performances des requêtes.

Note

Les indicateurs de requête peuvent être utiles dans les scénarios où vous ne pouvez pas modifier immédiatement le code de l’application ou avoir besoin d’atténuer temporairement les performances médiocres d’une requête. Une fois que vous avez identifié et résolu la cause racine du problème de performances, supprimez l’indicateur de requête.

Quel que soit votre rôle, l’outil recommandation d’indicateur de requête peut vous aider à devenir plus efficace pour trouver un ou plusieurs indicateurs de requête afin d’améliorer les performances d’une requête.

Get started

L’outil Recommandation d’indicateur de requête fonctionne avec une requête unique dans la fenêtre de l’éditeur de requête active. Il exécute la requête avec différents indicateurs de requête appliqués.

  1. Connectez-vous à une base de données dans une fenêtre d’éditeur de requête.
  2. Sélectionnez l’intégralité de la requête que vous souhaitez évaluer par l’outil.
  3. Ouvrez l’outil de recommandation d'indicateurs de requête en sélectionnant Outils>Outil de recommandation d'indicateur de requête.
  4. La fenêtre d'outil s'ouvre à côté de l’éditeur de requête.
  5. Entrez les paramètres d’entrée suivants :
    1. Temps de réglage maximal : durée totale maximale, en secondes, que l'outil consacre à essayer de trouver un indicateur de requête bénéfique. La valeur par défaut est 300 secondes (cinq minutes).
      1. Pourcentage d’amélioration minimal : pourcentage minimal d’amélioration des performances des requêtes que vous êtes prêt à accepter. Ce paramètre permet de filtrer les indicateurs moins efficaces et d’utiliser le temps alloué sur les indicateurs qui peuvent apporter une amélioration significative. Spécifiez ce paramètre en pourcentage. La valeur par défaut est 50%, ou au moins une amélioration de 2x dans le temps écoulé.
  6. Sélectionnez Démarrer pour commencer à exécuter la requête avec différents indicateurs.

Capture d’écran de la fenêtre de l'outil de recommandation d'indices de requêtes.

Key Descriptif
1 Barre de titre
2 Contrôles de la fenêtre d'outils pour épingler ou fermer la fenêtre
3 Paramètres d’entrée requis (temps de réglage maximal et pourcentage d’amélioration minimal)
4 Bouton de sélection de dossiers
5 Bouton Démarrer (lancer l’exploration de l’indicateur de requête)
6 Options avancées pour configurer l’espace des indicateurs de requête
7 Résumé des recommandations d'indice
8 Graphique pour visualiser l’amélioration de la durée des requêtes
9 Activer/masquer le graphique
10 Vue tabulaire des indicateurs de requête explorés

Fichier journal

L’outil Recommandation d’indicateur de requête crée un fichier journal qui contient des informations détaillées sur le processus d’évaluation, y compris les erreurs, et peut être utile pour la résolution des problèmes. Le fichier journal est stocké dans votre %TEMP% dossier par défaut. Vous pouvez modifier l’emplacement à l’aide du bouton de sélection de dossiers dans la fenêtre outil.

Visualisation du processus de paramétrage

L’outil Recommandation de l’indicateur de requête inclut un graphique qui fournit une représentation visuelle du processus de paramétrage. Ce graphique vous montre l’impact sur les performances des différents indicateurs de requête en temps réel. Le graphique comprend une mesure de performances de référence, puis superpose les performances des indicateurs de plus en plus utiles à mesure qu’ils sont trouvés.

Vue tabulaire des indicateurs explorés

L’outil Recommandation des indicateurs de requête fournit également une vue tabulaire de tous les indicateurs explorés. Cette vue inclut des informations clés telles que le texte indicatif, son impact sur les performances, et indique s'il a été ignoré pour économiser du temps de réglage. Utilisez cette vue pour évaluer rapidement l’efficacité des différents indicateurs et prendre une décision éclairée sur l’indicateur à appliquer.

Colonne Descriptif
Timestamp L'heure à laquelle la requête a été exécutée avec le hint de requête spécifié.
Identifiant du test Identificateur unique du test.
Temps écoulé (ms) Durée d’exécution de la requête avec l’indicateur de requête appliqué, mesuré en millisecondes (ms). Lorsque la requête n’est pas exécutée avec l’indicateur de requête spécifique, la raison d’ignorer l’exécution est incluse.
Gain en pourcentage Amélioration du pourcentage de durée d’exécution de requête obtenue par l’indicateur de requête.
Hint Indicateur de requête appliqué à la requête.

Ignorer les indicateurs de requête

L’outil Recommandation d’indicateur de requête utilise les critères suivants pour améliorer l’efficacité du réglage en ignorant certains indicateurs.

Ignorer la raison Descriptif
Plan de requête non valide Un plan de requête valide n’est pas généré lorsque l’indicateur de requête est appliqué à la requête.
Ignoré (aucune amélioration attendue) L’utilisation de l’indicateur de requête crée un plan d’exécution identique à un indicateur précédemment appliqué, ou n’est pas censé vous aider à comparer avec le meilleur indicateur de requête trouvé jusqu’à présent.
Arrêté (dépasser la limite de temps) L’exécution de la requête est stoppée car sa durée attendue dépasse celle du meilleur plan disponible.

Ajouter un indicateur à la requête sélectionnée

L’outil Recommandation d’indicateur de requête vous permet d’ajouter facilement un indicateur à la requête actuellement sélectionnée dans la fenêtre de l’éditeur. Cette option simplifie le processus d’application d’un indicateur sans modifier manuellement le texte de la requête.

  1. Vérifiez que la requête est mise en surbrillance dans la fenêtre de l’éditeur.
  2. Cliquez avec le bouton droit sur l’indicateur de requête à appliquer.
  3. Sélectionnez Ajouter un indice à la requête.
  4. L’indicateur de requête est ajouté à la requête dans l’éditeur.

Pour conserver l’indicateur de requête au-delà de l’exécution de la requête dans l’éditeur, appliquez-le en tant qu’indicateur du Query Store. Pour plus d’informations, consultez les indices de Query Store.

Options avancées

L’outil Recommandation des indicateurs de requête fournit des options avancées pour personnaliser l’espace des indicateurs de requête. Ces options vous permettent de configurer des indicateurs spécifiques à explorer, notamment :

  • Indicateurs d’espace de plan : indicateurs qui contrôlent les opérateurs et l’ordre de jointure dans la requête.
  • Indicateurs de modèle de cardinalité : indicateurs qui modifient le modèle de cardinalité utilisé pour estimer les cardinalités dans le plan d’exécution.
  • Divers : autres indicateurs de requête, notamment le contrôle du degré de parallélisme.

Par défaut, l’outil Recommandation des indicateurs de requête explore tous les indicateurs de requête prédéfinis et certaines combinaisons d’indicateurs de requête. Le panneau options avancées vous permet de personnaliser l’espace des indicateurs à explorer, comme l’exclusion des combinaisons d’indicateurs, certaines catégories d’indicateurs ou des indicateurs spécifiques.

Capture d’écran des options avancées de l’outil recommandé de l’indicateur de requête.