sys.query_store_query_hints (Transact-SQL)

Aplica-se a: SQL Server 2022 (16.x) e versões posteriores Azure SQL Database 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;

Conteúdo relacionado

• Dicas do Query Store
• sys.sp_query_store_set_hints
• sys.sp_query_store_clear_hints
• sys.query_store_query (Transact-SQL)