Compartilhar via

sp_query_store_reset_exec_stats (Transact-SQL)

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores Azure SQL DatabaseAzure SQL Managed InstanceSQL database in Microsoft Fabric

Limpa as estatísticas de runtime de um plano de consulta específico do Repositório de Consultas.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_query_store_reset_exec_stats [ @plan_id = ] plan_id
[ ; ]

Argumentos

Importante

Os argumentos para procedimentos armazenados estendidos devem ser inseridos na ordem específica, conforme descrito na seção sintaxe. Se os parâmetros forem inseridos fora de ordem, ocorrerá uma mensagem de erro.

@plan_id [ = ] plan_id

A ID do plano de consulta a ser limpo. @plan_id é bigint, sem padrão.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Permissões

Requer a permissão ALTER no banco de dados.

Observações

Se você habilitar o Repositório de Consultas para réplicas secundárias, o sp_query_store_reset_exec_stats só poderá ser executado na réplica primária. O escopo do procedimento se aplica a todo o conjunto de réplicas. A Loja de Consultas para réplicas secundárias é suportada a partir do SQL Server 2025 (17.x) e versões posteriores, além do Azure SQL Database. Para suporte completo à plataforma, veja Loja de Consultas para réplicas secundárias.

Exemplos

O exemplo a seguir retorna informações sobre as consultas no Repositório de Consultas.

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;

Depois de identificar o plan_id que você deseja limpar as estatísticas, use o exemplo a seguir para excluir as estatísticas de execução de um plano de consulta específico. Este exemplo exclui as estatísticas de execução do plano número 3.

EXECUTE sp_query_store_reset_exec_stats 3;

Conteúdo relacionado

  • Last updated on