sys.dm_exec_cached_plans (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Banco de dados SQL no Microsoft Fabric

Retorna uma linha para cada plano de consulta armazenado em cache pelo SQL Server para uma execução de consulta mais rápida. É possível usar esta exibição de gerenciamento dinâmico para localizar planos de consulta em cache, texto de consulta em cache, a quantidade de memória usada pelos planos em cache e o número de reutilizações dos planos em cache.

No Banco de Dados SQL do Azure, as exibições de gerenciamento dinâmico não podem expor informações que impactam a contenção do banco de dados ou expõem informações sobre outros bancos de dados aos quais o usuário tem acesso. Para evitar expor essas informações, todas as linhas que contêm dados que não pertencem ao locatário conectado são filtradas. Além disso, os valores nas colunas memory_object_address e pool_id são filtrados; o valor da coluna é definido como NULL.

Permissões

O SQL Server 2019 (15.x) e versões anteriores exigem VIEW SERVER STATE permissão.

O SQL Server 2022 (16.x) e versões posteriores e a Instância Gerenciada de SQL do Azure exigem VIEW SERVER PERFORMANCE STATE permissão.

Nos objetivos de serviço Básico, S0 e S1 do Banco de Dados Em todos os outros objetivos de serviço do Banco de Dados SQL, a permissão VIEW DATABASE STATE no banco de dados ou a associação à função de servidor ##MS_ServerStateReader## são necessárias.

Exemplos

R. Retornar o texto em lote de entradas armazenadas em cache que são reutilizados

O exemplo seguinte retorna o texto SQL de todas as entradas em cache que foram usadas mais de uma vez.

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. Retornar planos de consulta para todos os gatilhos armazenados em cache

O exemplo seguinte retorna os planos de consulta de todos os gatilhos em cache.

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. Retornar as opções SET com as quais o plano foi compilado

O exemplo a seguir retorna as SET opções com as quais o plano foi compilado. O sql_handle para o plano também é retornado. O PIVOT operador é usado para gerar os atributos e sql_handle os set_options atributos como colunas e não como linhas. Para obter mais informações sobre o valor retornado set_options, consulte 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. Retornar a divisão de memória de todos os planos compilados em cache

O exemplo seguinte retorna uma análise da memória usada por todos os planos compilados no cache.

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';

Conteúdo relacionado

• Exibições de gerenciamento dinâmico do sistema
• Funções e exibições de gerenciamento dinâmico relacionadas à execução (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)
• Cláusula FROM mais JOIN, APPLY, PIVOT (Transact-SQL)