Partager via

sp_query_store_unforce_plan (Transact-SQL)

S’applique à : SQL Server 2016 (13.x) et versions ultérieures d’Azure SQL DatabaseAzure SQL Managed Instance

Active l’application d’un plan précédemment forcé pour une requête particulière dans le Magasin des requêtes.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_query_store_unforce_plan
    [ @query_id = ] query_id ,
    [ @plan_id = ] plan_id ,
    [ @replica_group_id = ] 'replica_group_id'
[ ; ]

Les 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.

[ @query_id = ] query_id

ID de la requête. @query_id est bigint, sans valeur par défaut.

[ @plan_id = ] plan_id

ID du plan de requête qui ne sera plus appliqué. @plan_id est bigint, sans valeur par défaut.

[ @replica_group_id = ] 'replica_group_id'

Vous pouvez annuler les plans sur un réplica secondaire lorsque le Magasin des requêtes pour les fichiers secondaires lisibles est activé. Exécutez sp_query_store_force_plan et sp_query_store_unforce_plan sur le réplica principal. L’utilisation de l’argument @replica_group_id par défaut pour le réplica local où la commande est exécutée, mais vous pouvez spécifier un replica_group_id référençant l’affichage catalogue système sys.query_store_plan_forcing_locations .

Valeurs des codes de retour

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

autorisations

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

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 query_id et les plan_id que vous souhaitez annuler, utilisez l’exemple suivant pour annuler l’application du plan.

EXECUTE sp_query_store_unforce_plan 3, 3;

Contenu connexe

  • Last updated on