sys.query_store_plan_forcing_locations (Transact-SQL)

Van toepassing op: SQL Server 2025 (17.x) Azure SQL Database

Bevat informatie over Query Store plannen die door het gebruik van sp_query_store_force_plan worden afgedwongen. Gebruik deze informatie om te bepalen welke queries plannen hebben die worden geforceerd op de lees/schrijfreplica (primaire) van een database en één of meer read-only replica's.

Kolomnaam Gegevenstype Description
plan_forcing_location_id bigint Systeem-toegewezen ID voor dit plan dwingt locatie te forceren.
query_id bigint Referenties query_id in sys.query_store_query
plan_id bigint Referenties plan_id in sys.query_store_plan
replica_group_id bigint Van de parameter force_plan_scope in sp_query_store_force_plan (Transact-SQL). Referenties replica_group_id in sys.query_store_replicas
timestamp datetime UTC-datum en -tijd waarop de plan-dwingende operatie werd toegepast.
plan_forcing_type int Soort plan dwingen.

0 = NONE
1 = MANUAL
2 = AUTO
plan_forcing_type_desc nvarchar(60) Tekstbeschrijving van plan_forcing_type.

NONE: Geen plan afdwingen
MANUAL: Plan afgedwongen door een gebruiker
AUTO: Plan gedwongen door automatische stemming

Permissions

Hiervoor is de machtiging VIEW DATABASE STATE vereist.

Machtigingen voor SQL Server 2022 en hoger

Vereist de VIEW DATABASE PERFORMANCE STATE machtiging voor de database.

Example

Gebruik sys.query_store_plan_forcing_locations, samen met sys.query_store_replicas, om de top 20 Query Store plannen die zijn geforceerd terug te halen.

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;

Verwante inhoud

  • Laatst bijgewerkt om