sys.query_store_plan_forcing_locations (Transact-SQL)

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

Contém informações sobre Query Store planos que são forçados pela utilização de sp_query_store_force_plan. Use esta informação para determinar quais consultas têm planos forçados à réplica de leitura/escrita (primária) da base de dados e a uma ou mais réplicas apenas de leitura.

Nome da coluna Tipo de dados Description
plan_forcing_location_id bigint ID atribuído pelo sistema para este plano, forçando a localização.
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 A partir 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 plano.

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 utilizador
AUTO: Plano forçado por afinação automática

Permissions

Requer a permissão de VIEW DATABASE STATE.

Permissões para SQL Server 2022 e posterior

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

Example

Use sys.query_store_plan_forcing_locations, juntamente com sys.query_store_replicas, para recuperar os 20 melhores planos Query Store 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 a