Partager via

sp_query_store_reset_exec_stats (Transact-SQL)

S’applique à : SQL Server 2016 (13.x) et versions ultérieures Azure SQL SQL ManagedInstanceSQL database in Microsoft Fabric

Efface du Magasin des requêtes les statistiques d’exécution d’un plan de requête spécifique.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_query_store_reset_exec_stats [ @plan_id = ] plan_id
[ ; ]

Arguments

Important

Les arguments des procédures stockées étendues doivent être entrés dans l’ordre spécifique, comme décrit dans la section syntaxe. Si les paramètres sont entrés hors ordre, un message d’erreur se produit.

[ @plan_id = ] plan_id

ID du plan de requête à effacer. @plan_id est bigint, sans valeur par défaut.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

autorisations

Exige l’autorisation ALTER sur la base de données.

Remarques

Si vous activez l’option Magasin des requêtes pour les réplicas secondaires, sp_query_store_reset_exec_stats peut uniquement s’exécuter sur le réplica principal. L’étendue de la procédure s’applique à l’ensemble du jeu de réplicas. Le magasin de requêtes pour les répliques secondaires est pris en charge à partir de SQL Server 2025 (17.x) et versions ultérieures, ainsi que dans Azure SQL Database. Pour la prise en charge complète de la plateforme, voir Query Store pour les répliques secondaires.

Exemples

L’exemple suivant retourne des informations sur les requêtes dans le Magasin des requêtes.

SELECT txt.query_text_id,
       txt.query_sql_text,
       pl.plan_id,
       qry.*
FROM sys.query_store_plan AS pl
     INNER JOIN sys.query_store_query AS qry
         ON pl.query_id = qry.query_id
     INNER JOIN sys.query_store_query_text AS txt
         ON qry.query_text_id = txt.query_text_id;

Après avoir identifié les plan_id que vous souhaitez effacer les statistiques, utilisez l’exemple suivant pour supprimer les statistiques d’exécution d’un plan de requête spécifique. Cet exemple supprime les statistiques d’exécution du plan numéro 3.

EXECUTE sp_query_store_reset_exec_stats 3;

Contenu connexe

  • Last updated on