sp_query_store_clear_hints (Transact-SQL)

2025-07-25

Область применения:SQL Server 2022 (16.x) База данных SQL Azure Управляемый экземпляр SQL Azure

Удаляет все хранилище запросов подсказки для заданного идентификатора запроса.

Syntax

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

Arguments

Important

Аргументы для расширенных хранимых процедур необходимо ввести в определенном порядке, как описано в разделе Синтаксис. Если параметры введены вне порядка, возникает сообщение об ошибке.

[ @query_id = ] query_id

Столбец хранилище запросов query_id из sys.query_store_query. query_id является bigint.

[ @replica_group_id = ] 'replica_group_id'

Необязательный аргумент @replica_group_id по умолчанию использует локальную реплику (первичную или вторичную), но при необходимости можно указать значение, соответствующее значению в столбце в replica_group_idsys.query_store_replicas , чтобы очистить указание для другой группы реплик. @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;