Delen via


sp_query_store_clear_hints (Transact-SQL)

van toepassing op: SQL Server 2022 (16.x) Azure SQL DatabaseAzure SQL Managed Instance

Hiermee verwijdert u alle Query Store-hints voor een bepaalde query-id.

Transact-SQL syntaxisconventies

Syntax

sp_query_store_clear_hints
    [ @query_id = ] query_id
    [ , [ @replica_group_id = ] 'replica_group_id' ]
[ ; ]

Arguments

Important

Argumenten voor uitgebreide opgeslagen procedures moeten worden ingevoerd in de specifieke volgorde, zoals beschreven in de sectie Syntaxis. Als de parameters niet in de volgorde zijn ingevoerd, treedt er een foutbericht op.

[ @query_id = ] query_id

De kolom Query Store query_id uit sys.query_store_query. query_id is grote.

[ @replica_group_id = ] 'replica_group_id'

Het optionele @replica_group_id argument wordt standaard ingesteld op de lokale replica (primair of secundair), maar u kunt desgewenst een waarde opgeven die overeenkomt met een waarde in de replica_group_id kolom in sys.query_store_replicas om een hint voor een andere replicagroep te wissen. @replica_group_id is bigint.

Return value

0 (geslaagd) of 1 (mislukt).

Remarks

Query Store-hints worden gemaakt door sys.sp_query_store_set_hints.

Permissions

Vereist de ALTER machtiging voor de database.

Examples

Hinttekst voor query wissen

In het volgende voorbeeld wordt de hinttekst van Query Store voor query_id 39 verwijderd:

EXECUTE sys.sp_query_store_clear_hints @query_id = 39;

Query Store-hints weergeven

In het volgende voorbeeld worden bestaande Query Store-hints geretourneerd voor query_id 39:

SELECT query_hint_id,
       query_id,
       replica_group_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;