sys.query_store_query_hints (Transact-SQL)

Aplica-se a: SQL Server 2022 (16.x) e versões posteriores Base de Dados SQL do Azure AzureSQL Managed InstanceSQL database in Microsoft Fabric

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

Nome da coluna Tipo de dados Description
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 coluna query_id no sys.query_store_query.
replica_group_id bigint Determina o escopo no qual a dica é aplicada, de acordo com a coluna replica_group_id em sys.query_store_replicas.
query_hint_text nvarchar(max) Definição de dica em forma de N'OPTION (...)
last_query_hint_failure_reason int Código de erro retornado quando a aplicação de dicas falhou. Inclui o message_id da 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 do Repositório de Consultas.
comment nvarchar(max) Apenas para uso interno.

Remarks

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.

Permissions

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

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

Examples

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