Поделиться через


sp_query_store_reset_exec_stats (Transact-SQL)

Относится к: SQL Server 2016 (13.x) и более поздние версии Azure SQL DatabaseAzure SQL Managed InstanceSQL Database в Microsoft Fabric

Очищает статистику среды выполнения для определенного плана запроса из хранилище запросов.

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

Синтаксис

sp_query_store_reset_exec_stats [ @plan_id = ] plan_id
[ ; ]

Аргументы

Важный

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

[ @plan_id = ] plan_id

Идентификатор плана запроса, который необходимо очистить. @plan_id является bigint, без значения по умолчанию.

Значения кода возврата

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

Разрешения

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

Замечания

Если хранилище запросов включено для вторичных реплик, sp_query_store_reset_exec_stats можно выполнять только для первичной реплики. Область процедуры применяется ко всему набору реплик. Хранилище запросов для вторичных реплик поддерживается начиная с SQL Server 2025 (17.x) и более поздних версий, а также в Azure SQL Database. Для полной поддержки платформы см. Query Store для вторичных реплик.

Примеры

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

SELECT txt.query_text_id,
       txt.query_sql_text,
       pl.plan_id,
       qry.*
FROM sys.query_store_plan AS pl
     INNER JOIN sys.query_store_query AS qry
         ON pl.query_id = qry.query_id
     INNER JOIN sys.query_store_query_text AS txt
         ON qry.query_text_id = txt.query_text_id;

После идентификации plan_id , которую требуется очистить статистику, используйте следующий пример, чтобы удалить статистику выполнения для определенного плана запроса. В этом примере удаляется статистика выполнения для плана номер 3.

EXECUTE sp_query_store_reset_exec_stats 3;