sp_query_store_unforce_plan (Transact-SQL)
Applies to:
SQL Server 2016 (13.x) and later
Azure SQL Database
Azure SQL Managed Instance
Enables unforcing a previously forced plan for a particular query.
Transact-SQL syntax conventions
Syntax
sp_query_store_unforce_plan
[ @query_id = ] query_id ,
[ @plan_id = ] plan_id,
[ @force_plan_scope = ] replica_group_id [;]
Arguments
[ @query_id = ] query_id
Is the query_id
of the query. query_id
is a bigint, with no default.
[ @plan_id = ] plan_id
Is the plan_id
of the query plan that will no longer be enforced. plan_id
is a bigint, with no default.
[ @force_plan_scope = ] replica_group_id
You can force and unforce plans on a secondary replica when Query Store for secondary replicas is enabled. Execute sp_query_store_force_plan
and sp_query_store_unforce_plan
on the secondary replica. The optional force_plan_scope argument defaults only to the local replica, but you can optionally specify a replica_group_id
referencing sys.query_store_plan_forcing_locations.
Return Code Values
0 (success) or 1 (failure)
Remarks
Permissions
Requires the ALTER permission on the database.
Examples
The following example returns information about the queries in the query store.
SELECT Txt.query_text_id, Txt.query_sql_text, Pl.plan_id, Qry.*
FROM sys.query_store_plan AS Pl
JOIN sys.query_store_query AS Qry
ON Pl.query_id = Qry.query_id
JOIN sys.query_store_query_text AS Txt
ON Qry.query_text_id = Txt.query_text_id ;
After you identify the query_id
and plan_id
that you want to unforce, use the following example to unforce the plan.
EXEC sp_query_store_unforce_plan 3, 3;
Next steps
- sys.query_store_replicas (Transct-SQL)
- sys.query_store_plan_forcing_locations (Transact-SQL)
- sp_query_store_force_plan (Transact-SQL)
- sp_query_store_remove_plan (Transct-SQL)
- sp_query_store_remove_query (Transact-SQL)
- sp_query_store_reset_exec_stats (Transact-SQL)
- sp_query_store_flush_db (Transact-SQL)
- Query Store Catalog Views (Transact-SQL)
- Monitoring Performance by using the Query Store
- Best Practice with the Query Store