sys.query_store_plan_forcing_locations (Transact-SQL)

S’applique à : SQL Server 2025 (17.x) Azure SQL Database

Contient des informations sur Magasin des requêtes plans imposés par l’utilisation de sp_query_store_force_plan. Utilisez ces informations pour déterminer quelles requêtes ont des plans imposés sur la réplique de lecture/écriture (principale) d’une base de données et une ou plusieurs répliques en lecture seule.

Nom de la colonne Type de données Description
plan_forcing_location_id bigint ID attribué par le système pour cet emplacement forçant le plan.
query_id bigint Références query_id dans sys.query_store_query
plan_id bigint Références plan_id dans sys.query_store_plan
replica_group_id bigint À partir du paramètre force_plan_scope dans sp_query_store_force_plan (Transact-SQL). Références replica_group_id dans sys.query_store_replicas
timestamp datetime UTC date et heure de l’application de l’opération de forcement du plan.
plan_forcing_type int Un type de forçage de plan.

0 = NONE
1 = MANUAL
2 = AUTO
plan_forcing_type_desc nvarchar(60) Description textuelle de plan_forcing_type.

NONE: Aucun plan forçant
MANUAL: Plan imposé par un utilisateur
AUTO: Plan forcé par réglage automatique

autorisations

Nécessite l’autorisation VIEW DATABASE STATE.

Autorisations pour SQL Server 2022 et versions ultérieures

Nécessite l’autorisation VIEW DATABASE PERFORMANCE STATE sur la base de données.

Exemple

Utilisez sys.query_store_plan_forcing_locations, associé à sys.query_store_replicas, pour récupérer les 20 meilleurs plans Magasin des requêtes qui ont été forcés.

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;