sp_query_store_unforce_plan (Transact-SQL)

適用対象:SQL Server 2016 (13.x) 以降のデータベースAzure SQLAzure SQL Managed Instance

特定のクエリに対して以前に強制されたプランの適用を解除できるようにします。

Transact-SQL 構文表記規則

構文

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

引数

[ @query_id = ] query_id

query_idクエリの です。 query_idbigint で、既定値はありません。

[ @plan_id = ] plan_id

plan_id適用されなくなるクエリ プランの です。 plan_idbigint で、既定値はありません。

[ @force_plan_scope = ] replica_group_id

セカンダリ レプリカのクエリ ストアが有効になっている場合は、セカンダリ レプリカに対してプランを強制および強制解除できます。 セカンダリ レプリカで と sp_query_store_unforce_plan を実行sp_query_store_force_planします。 省略可能な force_plan_scope 引数の既定値はローカル レプリカのみですが、必要に応じて参照sys.query_store_plan_forcing_locationsreplica_group_id指定することもできます。

リターン コードの値

0 (成功) または 1 (失敗)

解説

アクセス許可

データベースに対する ALTER 権限が必要です。

次の例では、クエリ ストア内のクエリに関する情報が返されます。

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 ;

強制を解除する と plan_idquery_id特定したら、次の例を使用してプランの適用を解除します。

EXEC sp_query_store_unforce_plan 3, 3;

次のステップ