sys.query_store_plan_forcing_locations (Transact-SQL)

Aplica-se a: SQL Server 2025 (17.x) Banco de Dados SQL do Azure

Contém informações sobre Repositório de Consultas planos que são forçados pelo uso de sp_query_store_force_plan. Use essas informações para determinar quais consultas têm planos forçados à réplica de leitura/escrita (primária) de um banco de dados e a uma ou mais réplicas somente leitura.

Nome da coluna Tipo de dados Descrição
plan_forcing_location_id bigint ID atribuída pelo sistema para este local de força de plano.
query_id bigint Referências query_id em sys.query_store_query
plan_id bigint Referências plan_id em sys.query_store_plan
replica_group_id bigint Do parâmetro force_plan_scope em sp_query_store_force_plan (Transact-SQL). Referências replica_group_id em sys.query_store_replicas
timestamp datetime Data e hora UTC em que a operação de forçamento do plano foi aplicada.
plan_forcing_type int Tipo de forçamento de planejamento.

0 = NONE
1 = MANUAL
2 = AUTO
plan_forcing_type_desc nvarchar(60) Descrição do texto de plan_forcing_type.

NONE: Sem forçar o plano
MANUAL: Plano forçado por um usuário
AUTO: Plano forçado por sintonia automática

Permissões

Requer a permissão VIEW DATABASE STATE.

Permissões para SQL Server 2022 e posterior

Requer a VIEW DATABASE PERFORMANCE STATE permissão no banco de dados.

Exemplo

Use sys.query_store_plan_forcing_locations, junto com sys.query_store_replicas, para recuperar os 20 melhores planos Repositório de Consultas que foram forçados.

SELECT TOP (20)
    pfl.query_id,
    pfl.plan_id,
    CASE qsr.replica_group_id
        WHEN 1 THEN 'PRIMARY'
        WHEN 2 THEN 'SECONDARY'
        WHEN 3 THEN 'GEO SECONDARY'
        WHEN 4 THEN 'GEO HA SECONDARY'
        ELSE CONCAT('REPLICA_', qsr.replica_group_id)
    END AS replica_type,
    pfl.[timestamp],
    pfl.plan_forcing_type_desc
FROM sys.query_store_plan_forcing_locations AS pfl
INNER JOIN sys.query_store_replicas AS qsr
    ON qsr.replica_group_id = pfl.replica_group_id
ORDER BY pfl.[timestamp] DESC;

Conteúdo relacionado

  • Última atualização em