sp_query_store_clear_hints (Transact-SQL)

适用于:SQL Server 2022 (16.x) Azure SQL 数据库Azure SQL 托管实例

删除给定查询 ID 的所有查询存储提示

Transact-SQL 语法约定

Syntax

sp_query_store_clear_hints
    [ @query_id = ] query_id
    [ , [ @replica_group_id = ] 'replica_group_id' ]
[ ; ]

Arguments

Important

扩展存储过程的参数必须按特定顺序输入,如 语法 节中所述。 如果参数按顺序输入,则会出现错误消息。

[ @query_id = ] query_id

来自sys.query_store_query的query_id查询存储 query_id是偏重的。

[ @replica_group_id = ] 'replica_group_id'

可选@replica_group_id参数默认为本地副本(主副本或辅助副本),但可以选择指定与sys.query_store_replicas列中的值匹配的值replica_group_id,以清除其他副本组的提示。 @replica_group_id偏重的。

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;