sp_query_store_set_hints (Transact-SQL)

  • Статья

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

Создает или обновляет подсказки хранилища запросов для заданного query_id.

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_query_store_set_hints
    [ @query_id = ] query_id ,
    [ @query_hints = ] 'query_hints'
    [ , [ @query_hint_scope = ] 'replica_group_id' ]
[ ; ]

Аргументы

[ @query_id = ] query_id

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

[ @query_hints = ] N'query_hints'

Символьная строка параметров запроса, начиная с 'OPTION. @query_hints — nvarchar(max). Дополнительные сведения см. в разделе "Поддерживаемые подсказки запросов" в этой статье.

[ @query_hint_scope = ] 'replica_group_id'

По умолчанию область нового указания хранилища запросов — это только локальная реплика. @query_hint_scope крошечный. Этот необязательный параметр определяет область применения указания на вторичной реплике при включении хранилища запросов для вторичных реплик. Необязательный аргумент query_hint_scope по умолчанию используется только для локальной реплики (основной или вторичной), но при необходимости можно указать replica_group_id ссылки sys.query_store_replicas.

Возвращаемые значения

0 (успешно) или 1 (сбой).

Замечания

Указания задаются в допустимом строковом формате T-SQL N'OPTION (..)'.

  • Если для определенного query_id нет указания хранилища запросов, будет создано новое указание хранилища запросов.
  • Если указание хранилища запросов уже существует для определенного query_id, последнее указанное значение переопределит ранее указанные значения для связанного запроса.
  • Если query_id не существует, возникает ошибка.

Если указание приведет к сбою запроса, оно игнорируется, а актуальные сведения о сбоях можно просмотреть в sys.query_store_query_hints.

Чтобы удалить указания, связанные с query_id, используйте системную хранимую процедуру sys.sp_query_store_clear_hints.

Поддерживаемые указания запросов

Эти указания запроса поддерживаются в виде указаний хранилища запросов:

{ HASH | ORDER } GROUP
  | { CONCAT | HASH | MERGE } UNION
  | { LOOP | MERGE | HASH } JOIN
  | EXPAND VIEWS
  | FAST number_rows
  | FORCE ORDER
  | IGNORE_NONCLUSTERED_COLUMNSTORE_INDEX
  | KEEP PLAN
  | KEEPFIXED PLAN
  | MAX_GRANT_PERCENT = percent
  | MIN_GRANT_PERCENT = percent
  | MAXDOP number_of_processors
  | NO_PERFORMANCE_SPOOL
  | OPTIMIZE FOR UNKNOWN
  | PARAMETERIZATION { SIMPLE | FORCED }
  | RECOMPILE
  | ROBUST PLAN
  | USE HINT ( '<hint_name>' [ , ...n ] )

Следующие указания запросов на данный момент не поддерживаются:

Разрешения

Необходимо разрешение ALTER для базы данных.

Примеры

Определение запроса в хранилище запросов

В следующем примере запросы sys.query_store_query_text и sys.query_store_query для возврата query_id для фрагмента текста выполненного запроса.

В этом примере запрос, который мы пытаемся настроить, находится в примере базы данных SalesLT.

SELECT * FROM SalesLT.Address as A
INNER JOIN SalesLT.CustomerAddress as CA
on A.AddressID = CA.AddressID
WHERE PostalCode = '98052' ORDER BY A.ModifiedDate DESC;

Хранилище запросов не сразу отражает данные запроса к системным представлениям.

Определите запрос в представлениях системного каталога хранилища запросов:

SELECT q.query_id, qt.query_sql_text
FROM sys.query_store_query_text qt
INNER JOIN sys.query_store_query q ON
    qt.query_text_id = q.query_text_id
WHERE query_sql_text like N'%PostalCode =%'
  AND query_sql_text not like N'%query_store%';
GO

В следующих примерах предыдущий пример запроса в SalesLT базе данных был определен как query_id 39.

Применение одного указания

В следующем примере применяется указание RECOMPILE к query_id 39, как указано в хранилище запросов:

EXEC sys.sp_query_store_set_hints @query_id= 39, @query_hints = N'OPTION(RECOMPILE)';

В следующем примере применяется указание для принудительного определениякратности прежних версий query_id 39, определенных в хранилище запросов:

EXEC sys.sp_query_store_set_hints @query_id= 39, @query_hints = N'OPTION(USE HINT(''FORCE_LEGACY_CARDINALITY_ESTIMATION''))';

Применение нескольких указаний

В следующем примере применяется несколько подсказок запросов к query_id 39, включая RECOMPILE, MAXDOP 1 и поведение оптимизатора запросов SQL 2012:

EXEC sys.sp_query_store_set_hints @query_id= 39, @query_hints = N'OPTION(RECOMPILE, MAXDOP 1, USE HINT(''QUERY_OPTIMIZER_COMPATIBILITY_LEVEL_110''))';

Просмотр указаний хранилища запросов

В следующем примере возвращаются существующие указания хранилища запросов.

SELECT query_hint_id, query_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;

Удаление указания из запроса

Используйте следующий пример, чтобы удалить подсказку из query_id 39, используя хранимую процедуру sp_query_store_clear_hints (Transact-SQL).

EXEC sys.sp_query_store_clear_hints @query_id = 39;

Далее