sys.dm_exec_cached_plans (Transact-SQL)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Database w Microsoft Fabric

Zwraca wiersz dla każdego planu zapytań, który jest buforowany przez SQL Server dla szybszego wykonywania zapytań. Możesz użyć tego dynamicznego widoku zarządzania, aby znaleźć plany zapytań w pamięci podręcznej, tekst zapytań w pamięci podręcznej, ilość pamięci zajmowanej przez plany buforowane oraz liczbę ponownych użycia tych planów.

W usłudze Azure SQL Database dynamiczne widoki zarządzania nie mogą ujawniać informacji, które mają wpływ na zawieranie bazy danych lub uwidacznianie informacji o innych bazach danych, do których użytkownik ma dostęp. Aby uniknąć uwidaczniania tych informacji, każdy wiersz zawierający dane, które nie należą do połączonej dzierżawy, jest filtrowany. Ponadto wartości w kolumnach memory_object_address i pool_id są filtrowane; wartość kolumny jest ustawiona na NULLwartość .

Permissions

Program SQL Server 2019 (15.x) i starsze wersje wymagają VIEW SERVER STATE uprawnień.

Program SQL Server 2022 (16.x) i nowsze wersje oraz usługa Azure SQL Managed Instance wymagają VIEW SERVER PERFORMANCE STATE uprawnień.

W przypadku celów usługi Azure SQL Database Basic, S0 i S1 oraz baz danych w elastycznych pulach wymagane jest konto administratora serwera , konto administratora firmy Microsoft Entra lub członkostwo w ##MS_ServerStateReader##roli serwera . We wszystkich innych celach usługi SQL Database wymagane VIEW DATABASE STATE jest uprawnienie do bazy danych lub członkostwo w ##MS_ServerStateReader## roli serwera.

Przykłady

A. Zwraca tekst wsadowy buforowanych wpisów, które są ponownie używane

Poniższy przykład zwraca tekst SQL wszystkich wpisów w pamięci podręcznej, które były używane więcej niż raz.

SELECT usecounts,
       cacheobjtype,
       objtype,
       text
FROM sys.dm_exec_cached_plans
CROSS APPLY sys.dm_exec_sql_text(plan_handle)
WHERE usecounts > 1
ORDER BY usecounts DESC;

B. Zwracanie planów zapytań dla wszystkich buforowanych wyzwalaczy

Poniższy przykład zwraca plany zapytań wszystkich buforowanych wyzwalaczy.

SELECT plan_handle,
       query_plan,
       objtype
FROM sys.dm_exec_cached_plans
CROSS APPLY sys.dm_exec_query_plan(plan_handle)
WHERE objtype = 'Trigger';

C. Zwraca opcje ZESTAWU, za pomocą których został skompilowany plan

Poniższy przykład zwraca SET opcje, z którymi został skompilowany plan. Plan sql_handle jest również zwrócony. Operator PIVOT służy do wyprowadzania set_options atrybutów i sql_handle jako kolumn, a nie jako wierszy. Aby uzyskać więcej informacji na temat wartości zwróconej w pliku set_options, zobacz sys.dm_exec_plan_attributes.

SELECT plan_handle,
       pvt.set_options,
       pvt.sql_handle
FROM (
    SELECT plan_handle,
           epa.attribute,
           epa.value
    FROM sys.dm_exec_cached_plans
        OUTER APPLY sys.dm_exec_plan_attributes(plan_handle) AS epa
    WHERE cacheobjtype = 'Compiled Plan'
) AS ecpa
PIVOT (MAX (ecpa.value) FOR ecpa.attribute IN ("set_options", "sql_handle")) AS pvt;

D. Zwraca podział pamięci wszystkich buforowanych skompilowanych planów

Poniższy przykład zwraca podział pamięci używanej przez wszystkie skompilowane plany w pamięci podręcznej.

SELECT plan_handle,
       ecp.memory_object_address AS CompiledPlan_MemoryObject,
       omo.memory_object_address,
       type,
       page_size_in_bytes
FROM sys.dm_exec_cached_plans AS ecp
     INNER JOIN sys.dm_os_memory_objects AS omo
        ON ecp.memory_object_address = omo.memory_object_address
        OR ecp.memory_object_address = omo.parent_address
WHERE cacheobjtype = 'Compiled Plan';

Treści powiązane

• dynamiczne widoki zarządzania systemu
• Dynamiczne widoki zarządzania i funkcje związane z wykonywaniem (Transact-SQL)
• sys.dm_exec_query_plan (Transact-SQL)
• sys.dm_exec_plan_attributes (Transact-SQL)
• sys.dm_exec_sql_text (Transact-SQL)
• sys.dm_os_memory_objects (Transact-SQL)
• sys.dm_os_memory_cache_entries (Transact-SQL)
• Klauzula FROM oraz JOIN, APPLY, PIVOT (Transact-SQL)