Compartilhar via


sp_query_store_remove_query (Transact-SQL)

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

Remove a consulta e todos os planos associados e estatísticas de runtime do Repositório de Consultas.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_query_store_remove_query [ @query_id = ] query_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.

@query_id [ = ] query_id

A ID da consulta a ser removida do Repositório de Consultas. @query_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.

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 query_id que você deseja excluir, use o exemplo a seguir para excluir a consulta.

EXECUTE sp_query_store_remove_query 3;