Condividi tramite


sp_query_store_clear_hints (Transact-SQL)

Si applica a: SQL Server 2022 (16.x) e versioni successive del databaseSQL di Azure Istanza gestita di SQL di Azurein Microsoft Fabric

Rimuove tutti gli hint di Query Store per un ID di query specificato.

Convenzioni relative alla sintassi Transact-SQL

Syntax

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

Arguments

Important

Gli argomenti per le stored procedure estese devono essere immessi nell'ordine specifico, come descritto nella sezione Sintassi. Se i parametri vengono immessi in ordine non corretto, si verifica un messaggio di errore.

[ @query_id = ] query_id

Colonna query store query_id da sys.query_store_query. query_id è bigint.

[ @replica_group_id = ] 'replica_group_id'

L'argomento facoltativo @replica_group_id viene impostato per impostazione predefinita sulla replica locale (primaria o secondaria), ma facoltativamente è possibile specificare un valore corrispondente a un valore nella replica_group_id colonna in sys.query_store_replicas per cancellare un hint per un gruppo di repliche diverso. @replica_group_id è bigint.

Valore restituito

0 (esito positivo) o 1 (errore).

Remarks

Gli hint di Query Store vengono creati da sys.sp_query_store_set_hints.

Permissions

È richiesta l'autorizzazione ALTER per il database.

Examples

Cancellare il testo dell'hint per la query

Nell'esempio seguente viene rimosso il testo dell'hint di Query Store per query_id 39:

EXECUTE sys.sp_query_store_clear_hints @query_id = 39;

Visualizzare gli hint di Query Store

L'esempio seguente restituisce gli hint di Query Store esistenti per 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;