sp_query_store_unforce_plan (Transact-SQL)

Artikel
2025-03-22

van toepassing op: SQL Server 2016 (13.x) en hoger Azure SQL Database Azure SQL Managed Instance

Hiermee schakelt u het afdwingen van een eerder geforceerd plan voor een bepaalde query in de Query Store in.

Syntaxis

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

Argumenten

Belangrijk

Argumenten voor uitgebreide opgeslagen procedures moeten worden ingevoerd in de specifieke volgorde, zoals beschreven in de sectie Syntaxis. Als de parameters niet in de volgorde zijn ingevoerd, treedt er een foutbericht op.

[ @query_id = ] query_id

De id van de query. @query_id is grote, zonder standaardinstelling.

[ @plan_id = ] plan_id

De id van het queryplan dat niet meer wordt afgedwongen. @plan_id is bigint, zonder standaardinstelling.

[ @force_plan_scope = ] 'replica_group_id'

U kunt plannen op een secundaire replica ongedaan maken wanneer Query Store voor secundaire replica's is ingeschakeld. Voer sp_query_store_force_plan en sp_query_store_unforce_plan uit op de primaire replica. Als u het argument @force_plan_scope gebruikt, wordt standaard de lokale replica gebruikt waar de opdracht wordt uitgevoerd, maar u kunt een replica_group_id opgeven die verwijst naar de sys.query_store_plan_forcing_locations systeemcatalogusweergave.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Machtigingen

Hiervoor is de machtiging ALTER vereist voor de database.

Voorbeelden

In het volgende voorbeeld wordt informatie geretourneerd over de query's in de Query Store.

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;

Nadat u de query_id en plan_id hebt geïdentificeerd die u wilt opheffen, gebruikt u het volgende voorbeeld om het plan ongedaan te maken.

EXEC sp_query_store_unforce_plan 3, 3;

Delen via