Compartilhar via


sys.query_store_query_hints (Transact-SQL)

Aplica-se a: SQL Server 2022 (16.x) Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

Retorna as dicas de consulta das dicas do Repositório de Consultas.

Nome da coluna Tipo de dados Descrição
query_hint_id bigint Identificador exclusivo de uma dica de consulta.
query_id bigint Identificador exclusivo de uma consulta no Repositório de Consultas. Chave estrangeira para a query_id coluna em sys.query_store_query.
query_hint_text nvarchar(max) Definição de dica na forma de N'OPTION (...)
last_query_hint_failure_reason int Código de erro retornado quando a aplicação de dicas falha. Inclui a message_id mensagem de erro.
last_query_hint_failure_reason_desc nvarchar(128) Inclui a descrição do erro da mensagem de erro.
query_hint_failure_count bigint Número de vezes que o aplicativo de dica de consulta falhou desde que a dica de consulta foi criada ou modificada pela última vez.
source int Fonte da dica do Repositório de Consultas: a fonte do usuário é zero e a gerada pelo sistema é diferente de zero.
source_desc nvarchar(128) Descrição da fonte da dica Repositório de Consultas.
comment nvarchar(max) Somente para uso interno.
query_hint_scope tinyint Determina o escopo no qual a dica é aplicada, de acordo com a replica_group_id coluna em sys.query_store_replicas.

Comentários

As dicas do Repositório de Consultas são criadas pelo sys.sp_query_store_set_hints e removidas pelo sys.sp_query_store_clear_hints.

Permissões

O SQL Server 2019 (15.x) e versões anteriores exigem VIEW SERVER STATE permissão no servidor.

O SQL Server 2022 (16.x) e versões posteriores exigem VIEW SERVER PERFORMANCE STATE permissão no servidor.

Exemplos

Exibir as dicas do Repositório de consultas

O seguinte exemplo retorna as dicas do Repositório de Consultas existentes para query_id 39:

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;