sys.query_store_plan_forcing_locations (Transact-SQL)

Gäller för: SQL Server 2025 (17.x) Azure SQL Database

Innehåller information om Query Store planer som tvingas av sp_query_store_force_plan. Använd denna information för att avgöra vilka frågor som har planer tvingade på en databass läs-/skrivreplika (primär) och en eller flera skrivskyddade repliker.

Kolumnnamn Datatyp Description
plan_forcing_location_id bigint Systemtilldelat ID för denna plan som tvingar plats.
query_id bigint Referenser query_id i sys.query_store_query
plan_id bigint Referenser plan_id i sys.query_store_plan
replica_group_id bigint Från parametern force_plan_scope i sp_query_store_force_plan (Transact-SQL). Referenser replica_group_id i sys.query_store_replicas
timestamp datetime UTC-datum och tid då den plantvingande operationen genomfördes.
plan_forcing_type int Typ av plan som tvingar fram den.

0 = NONE
1 = MANUAL
2 = AUTO
plan_forcing_type_desc nvarchar(60) Textbeskrivning av plan_forcing_type.

NONE: Ingen plan tvingar
MANUAL: Plan tvingad av en användare
AUTO: Plan tvingad av automatisk inställning

Permissions

Kräver behörigheten VIEW DATABASE STATE.

Behörigheter för SQL Server 2022 och senare

Kräver VIEW DATABASE PERFORMANCE STATE behörighet för databasen.

Example

Använd sys.query_store_plan_forcing_locations, tillsammans med sys.query_store_replicas, för att hämta de 20 bästa Query Store planer som har tvingats fram.

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;