適用対象:
SQL Server 2022 (16.x) Azure SQL データベースAzure SQL Managed Instance
特定のクエリ ID のクエリ ストアヒントをすべて削除します。
Syntax
sp_query_store_clear_hints
[ @query_id = ] query_id
[ , [ @replica_group_id = ] 'replica_group_id' ]
[ ; ]
Arguments
Important
拡張ストアド プロシージャの引数は、「構文の」セクションで説明されているように、特定の順序で入力する必要があります。 パラメーターが順に入力されていない場合は、エラー メッセージが表示されます。
[ @query_id = ] query_id
query_idのクエリ ストア 列。
query_id は bigint です。
[ @replica_group_id = ] 'replica_group_id'
省略可能 な@replica_group_id 引数は既定でローカル レプリカ (プライマリまたはセカンダリ) ですが、必要に応じて、sys.query_store_replicasの replica_group_id 列の値と一致する 値を指定 して、別のレプリカ グループのヒントをクリアできます。
@replica_group_id は bigint です。
Return value
0 (成功) または 1 (失敗)。
Remarks
クエリ ストアヒントは、sys.sp_query_store_set_hintsによって作成されます。
Permissions
データベースに対する ALTER 権限が必要です。
Examples
クエリ ヒントのテキストをクリアする
次の例では、query_id 39 のクエリ ストア ヒント テキストを削除します。
EXECUTE sys.sp_query_store_clear_hints @query_id = 39;
クエリ ストアのヒントを表示する
次の例では、query_id 39 の既存のクエリ ストア ヒントを返します。
SELECT query_hint_id,
query_id,
replica_group_id,
query_hint_text,
last_query_hint_failure_reason,
last_query_hint_failure_reason_desc,
query_hint_failure_count,
source,
source_desc
FROM sys.query_store_query_hints
WHERE query_id = 39;