sys.dm_exec_query_plan_stats (Transact-SQL)

SE APLICA A: SQL Server 2019 y versiones posteriores Azure SQL Database Azure Synapse Analytics Parallel Data Warehouse

Devuelve el equivalente del último plan de ejecución real conocido para un plan de consulta previamente almacenado en caché.

Sintaxis

sys.dm_exec_query_plan_stats(plan_handle)  

Argumentos

plan_handle
Es un token que identifica de forma única un plan de ejecución de consultas para un lote que se ha ejecutado y su plan reside en la caché del plan o se está ejecutando actualmente. plan_handle es varbinary(64).

La plan_handle se puede obtener de los siguientes objetos de administración dinámica:

• sys.dm_exec_cached_plans (Transact-SQL)

• sys.dm_exec_query_stats (Transact-SQL)

• sys.dm_exec_requests (Transact-SQL)

• sys.dm_exec_procedure_stats (Transact-SQL)

• sys.dm_exec_trigger_stats (Transact-SQL)

Tabla devuelta

Observaciones

Esta característica es opcional. Para habilitar en el nivel de servidor, use la marca de seguimiento 2451. Para habilitar en el nivel de base de datos, use la LAST_QUERY_PLAN_STATS en ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL).

Esta función del sistema funciona en la infraestructura de generación de perfiles de estadísticas de ejecución de consultas ligeras. Para obtener más información, vea Infraestructura de generación de perfiles de consultas.

La salida del plan de sys.dm_exec_query_plan_stats presentación de contiene la siguiente información:

• Toda la información en tiempo de compilación que se encuentra en el plan almacenado en caché
• Información en tiempo de ejecución, como el número real de filas por operador, el tiempo total de cpu y ejecución de la consulta, las advertencias de desbordamiento, el DOP real, la memoria máxima usada y la memoria concedida

En las condiciones siguientes, se devuelve una salida de Plan de presentación equivalente a un plan de ejecución real en la columna query_plan de la tabla devuelta para sys.dm_exec_query_plan_stats :

• El plan se puede encontrar en sys.dm_exec_cached_plans.
  AND
• La consulta que se ejecuta es compleja o consume recursos.

En las condiciones siguientes, se devuelve una salida simplificada ^de Plan de presentación en la query_plan de la tabla devuelta para sys.dm_exec_query_plan_stats :

• El plan se puede encontrar en sys.dm_exec_cached_plans.
  AND
• La consulta es lo suficientemente sencilla, normalmente clasificada como parte de una carga de trabajo oltp.

^{1 Hace} referencia a un plan de presentación que solo contiene el operador de nodo raíz (SELECT).

En las condiciones siguientes, no se devuelve ninguna salida de sys.dm_exec_query_plan_stats :

• El plan de consulta especificado mediante se ha expulsado de plan_handle la caché del plan.
  OR
• El plan de consulta no se podía almacenar en caché en primer lugar. Para obtener más información, vea Almacenamiento en caché del plan de ejecución y Reutilización de .

Permisos

Requiere el permiso VIEW SERVER STATE en el servidor.

Ejemplos

A. Consulta del último plan de ejecución de consultas real conocido para un plan almacenado en caché específico

En el ejemplo siguiente se sys.dm_exec_cached_plans para buscar el plan interesante y copiarlo plan_handle de la salida.

SELECT * FROM sys.dm_exec_cached_plans;  
GO  

A continuación, para obtener el último plan de ejecución de consultas real conocido, use el objeto copiado con la plan_handle función del sys.dm_exec_query_plan_stats.

SELECT * FROM sys.dm_exec_query_plan_stats(< copied plan_handle >);  
GO  

B. Consulta del último plan de ejecución de consultas real conocido para todos los planes almacenados en caché

SELECT *   
FROM sys.dm_exec_cached_plans AS cp
CROSS APPLY sys.dm_exec_sql_text(plan_handle) AS st
CROSS APPLY sys.dm_exec_query_plan_stats(plan_handle) AS qps;  
GO  

C. Consulta del último plan de ejecución de consultas real conocido para un plan almacenado en caché específico y texto de consulta

SELECT *   
FROM sys.dm_exec_cached_plans AS cp
CROSS APPLY sys.dm_exec_sql_text(plan_handle) AS st
CROSS APPLY sys.dm_exec_query_plan_stats(plan_handle) AS qps
WHERE st.text LIKE 'SELECT * FROM Person.Person%';  
GO  

D. Consulta de eventos almacenados en caché para el desencadenador

SELECT *
FROM sys.dm_exec_cached_plans
CROSS APPLY sys.dm_exec_query_plan_stats(plan_handle)
WHERE objtype ='Trigger';
GO

Consulte también

Marcas de seguimiento
Funciones y vistas de administración dinámica (Transact-SQL)
Vistas de administración dinámica relacionadas con la ejecución (Transact-SQL)