sp_query_store_force_plan (Transact-SQL)

适用于: SQL Server 2016 (13.x) 及更高版本 Azure SQL 数据库Azure SQL 托管实例

启用强制查询存储中特定查询的特定计划。

如果为特定查询强制应用某个计划,每当 SQL Server 遇到该查询时,它会尝试强制在查询优化器中执行此计划。 如果计划强制执行失败,将触发一个扩展事件,并且会指示查询优化器正常进行优化。

Transact-SQL 语法约定

语法

sp_query_store_force_plan
    [ @query_id = ] query_id ,
    [ @plan_id = ] plan_id ,
    [ @disable_optimized_plan_forcing = ] disable_optimized_plan_forcing ,
    [ @force_plan_scope = ] 'replica_group_id'
[ ; ]

参数

[ @query_id = ] query_id

查询的 ID。 @query_id为 bigint,没有默认值。

[ @plan_id = ] plan_id

要强制执行的查询计划的 ID。 @plan_idbigint,没有默认值。

[ @disable_optimized_plan_forcing = ] disable_optimized_plan_forcing

指示是否应禁用优化的计划强制。 @disable_optimized_plan_forcing是,默认值为 0.

[ @force_plan_scope = ] '副本 (replica)_group_id'

启用辅助副本 (replica)查询存储时,可以在辅助副本 (replica)上强制计划。 在辅助副本 (replica)上执行sp_query_store_force_plansp_query_store_unforce_plan执行。 可选@force_plan_scope参数默认为本地副本 (replica)(主要或辅助),但可以选择指定引用sys.query_store_副本 (replica)副本 (replica)_group_id。

返回代码值

0(成功)或 1(失败)。

注解

此功能强制生成的执行计划与强制计划相同或类似。 由于生成的计划可能与 sys.sp_query_store_force_plan 指定的计划不同,因此,计划的性能可能会有所不同。 在极少数情况下,性能差异可能很大,也可能是负面的;在这种情况下,管理员必须删除强制计划。

使用sys.query_store_plan_forcing_locations查看辅助副本 (replica)的强制计划。

权限

需要对数据库拥有 ALTER 权限。

示例

以下示例返回有关查询存储中的查询的信息。

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;

确定 要强制的query_idplan_id 后,请使用以下示例强制查询使用计划。

EXEC sp_query_store_force_plan
    @query_id = 3,
    @plan_id = 3;

使用与sys.query_store_副本 (replica)联接的sys.query_store_plan_forcing_locations检索强制在所有辅助副本 (replica)上强制查询存储计划。

SELECT query_plan
FROM sys.query_store_plan AS qsp
INNER JOIN sys.query_store_plan_forcing_locations AS pfl
    ON pfl.query_id = qsp.query_id
INNER JOIN sys.query_store_replicas AS qsr
    ON qsr.replica_group_id = qsp.replica_group_id
WHERE qsr.replica_name = 'yourSecondaryReplicaName';