Compartilhar via

sp_query_store_clear_hints (Transact-SQL)

Aplica-se a: SQL Server 2022 (16.x) e versões posteriores Banco de dados SQL do AzureInstância Gerenciada de SQL do AzureBanco de dados SQL no Microsoft Fabric

Remove todas as dicas do Repositório de Consultas para uma determinada ID de consulta.

Convenções de sintaxe de Transact-SQL

Syntax

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

Arguments

Important

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 coluna Repositório query_id de Consultas do sys.query_store_query. query_id é bigint.

@replica_group_id [ = ] 'replica_group_id'

O argumento @replica_group_id opcional é padrão para a réplica local (primária ou secundária), mas opcionalmente você pode especificar um valor correspondente a replica_group_id um valor na coluna em sys.query_store_replicas para limpar uma dica para um grupo de réplicas diferente. @replica_group_id é bigint.

Valor de retorno

0 (sucesso) ou 1 (falha).

Remarks

As dicas do Repositório de Consultas são criadas por sys.sp_query_store_set_hints.

Permissions

Requer a permissão ALTER no banco de dados.

Examples

Limpar o texto da dica de consulta

O exemplo a seguir remove o texto de dica do Repositório de Consultas para o query_id 39:

EXECUTE sys.sp_query_store_clear_hints @query_id = 39;

Exibir as dicas do Repositório de consultas

O exemplo a seguir retorna dicas existentes do Repositório de Consultas para o 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;

Conteúdo relacionado

  • Last updated on