Partage via

sp_query_store_unforce_plan (Transact-SQL)

  • Article

S’applique à : SQL Server 2016 (13.x) et versions ultérieures 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 ,
    [ @force_plan_scope = ] 'replica_group_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.

[ @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.

[ @force_plan_scope = ] 'replica_group_id'

Vous pouvez annuler les plans sur un réplica secondaire lorsque magasin de requêtes pour les réplicas secondaires 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 @force_plan_scope par défaut pour le réplica local où la commande est exécutée, mais vous pouvez spécifier une replica_group_id faisant référence à l’affichage catalogue système sys.query_store_plan_forcing_locations.

Valeurs des codes de retour

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

autorisations

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

EXEC sp_query_store_unforce_plan 3, 3;

Contenu connexe