sys.query_store_plan_forcing_locations (Transact-SQL)

Si applica a: SQL Server 2025 (17.x) database SQL di Azure

Contiene informazioni su Query Store piani imposti dall'uso di sp_query_store_force_plan. Usa queste informazioni per determinare quali query hanno piani imposti sulla replica di lettura/scrittura (primaria) di un database e su una o più repliche di sola lettura.

Nome colonna Tipo di dati Descrizione
plan_forcing_location_id bigint ID assegnato dal sistema per questo percorso forzato del piano.
query_id bigint Riferimenti query_id in sys.query_store_query
plan_id bigint Riferimenti plan_id in sys.query_store_plan
replica_group_id bigint Dal parametro force_plan_scope in sp_query_store_force_plan (Transact-SQL) . Riferimenti replica_group_id in sys.query_store_replicas
timestamp datetime Data e ora UTC in cui è stata applicata l'operazione di forzamento del piano.
plan_forcing_type int Tipo di costringenza pianificata.

0 = NONE
1 = MANUAL
2 = AUTO
plan_forcing_type_desc nvarchar(60) Descrizione del testo di plan_forcing_type.

NONE: nessuna forzatura del piano
MANUAL: Piano imposto da un utente
AUTO: Piano forzato da accordatura automatica

Autorizzazioni

È necessaria l'autorizzazione VIEW DATABASE STATE.

Autorizzazioni per SQL Server 2022 e versioni successive

È richiesta l'autorizzazione VIEW DATABASE PERFORMANCE STATE per il database.

Esempio

Usa sys.query_store_plan_forcing_locations, unito a sys.query_store_replicas, per recuperare i primi 20 Query Store piani che sono stati imposti.

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;