Edit

Share via

sp_query_store_clear_hints (Transact-SQL)

  • Article

Applies to: SQL Server 2022 (16.x) Azure SQL Database Azure SQL Managed Instance

Removes all Query Store hints for a given query ID.

Transact-SQL syntax conventions

Syntax

syntaxsql 
sp_query_store_clear_hints
    [ @query_id = ] query_id
[ ; ]

Arguments

[ @query_id = ] query_id

The Query Store query_id column from sys.query_store_query. query_id is bigint.

Return value

0 (success) or 1 (failure).

Remarks

Query Store hints are created by sys.sp_query_store_set_hints.

Permissions

Requires the ALTER permission on the database.

Examples

Clear query hint text

The following example removes the Query Store hint text for query_id 39:

SQL 
EXEC sys.sp_query_store_clear_hints @query_id = 39;

View Query Store hints

The following example returns existing Query Store hints for query_id 39:

SQL 
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;

Related content