Skip to content

sp-query-store-remove-query-transact-sql.md

Latest commit

 

History

History
87 lines (66 loc) · 2.81 KB

sp-query-store-remove-query-transact-sql.md

File metadata and controls

87 lines (66 loc) · 2.81 KB
title sp_query_store_remove_query (Transact-SQL)
description sp_query_store_remove_query (Transact-SQL)
author markingmyname
ms.author maghan
ms.reviewer randolphwest
ms.date 06/23/2025
ms.service sql
ms.subservice system-objects
ms.topic reference
ms.custom
ignite-2025
f1_keywords
SP_QUERY_STORE_REMOVE_QUERY
SP_QUERY_STORE_REMOVE_QUERY_TSQL
SYS.SP_QUERY_STORE_REMOVE_QUERY
SYS.SP_QUERY_STORE_REMOVE_QUERY_TSQL
helpviewer_keywords
sys.sp_query_store_remove_query
sp_query_store_remove_query
dev_langs
TSQL
monikerRange =azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current || =fabric-sqldb

sp_query_store_remove_query (Transact-SQL)

[!INCLUDE sqlserver2016-asdb-asdbmi-fabricsqldb]

Removes the query and all associated plans and runtime stats from the Query Store.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

sp_query_store_remove_query [ @query_id = ] query_id
[ ; ]

Arguments

[!INCLUDE extended-stored-procedures]

[ @query_id = ] query_id

The ID of the query to be removed from the Query Store. @query_id is bigint, with no default.

Return code values

0 (success) or 1 (failure).

Permissions

Requires the ALTER permission on the database.

Examples

The following example returns information about the queries in the 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;

After you identify the query_id that you want to delete, use the following example to delete the query.

EXECUTE sp_query_store_remove_query 3;

Related content