sys.dm_exec_function_stats (Transact-SQL)

Artículo
09/07/2023

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores Azure SQL Database Azure SQL Managed Instance

Devuelve estadísticas de rendimiento de agregado para las funciones en memoria caché. La vista devuelve una fila por cada plan de función almacenado en memoria caché y la vigencia de la fila corresponde al tiempo que la función permanece en memoria caché. Cuando se quita una función de la memoria caché, la fila correspondiente se elimina de esta vista. En ese momento, se genera un evento de Seguimiento de SQL de estadísticas de rendimiento similar a sys.dm_exec_query_stats. Devuelve información sobre las funciones escalares, incluidas las funciones en memoria y las funciones escalares CLR. No devuelve información sobre las funciones con valores de tabla y sobre las funciones escalares insertadas con la función de inserción escalar de UDF.

En Azure SQL Database, las vistas de administración dinámica no pueden mostrar información que afecte a la contención de la base de datos o que exponga datos acerca de otras bases de datos a las que el usuario tenga acceso. Para evitar exponer esta información, se filtran todas las filas que contienen datos que no pertenecen al inquilino conectado.

Nota:

Los resultados de sys.dm_exec_function_stats pueden variar con cada ejecución, ya que los datos solo reflejan las consultas finalizadas y no las que todavía están en curso.

Nombre de la columna	Tipo de datos	Descripción
database_id	int	Identificador de base de datos en que reside la función. En Azure SQL Database, los valores son únicos dentro de una base de datos única o un grupo elástico, pero no dentro de un servidor lógico.
object_id	int	Número de identificación del objeto de la función.
type	char(2)	Tipo del objeto: FN = Funciones escalares
type_desc	nvarchar(60)	Descripción del tipo de objeto: SQL_SCALAR_FUNCTION
sql_handle	varbinary(64)	Esto se puede usar para correlacionar con las consultas de sys.dm_exec_query_stats que se ejecutaron desde esta función.
plan_handle	varbinary(64)	Identificador del plan en memoria. Este identificador es transitorio y permanece constante solo mientras el plan permanece en la memoria caché. Este valor se puede usar con la vista de administración dinámica sys.dm_exec_cached_plans. Será siempre 0x000 cuando una función de compilación nativa consulte una tabla optimizada para memoria.
cached_time	datetime	Momento en que la función se agregó a la caché.
last_execution_time	datetime	Última vez que se ejecutó la función.
execution_count	bigint	Número de veces que se ha ejecutado la función desde que se compiló por última vez.
total_worker_time	bigint	Tiempo total de CPU, en microsegundos, consumido por las ejecuciones de esta función desde su compilación. Para las funciones de compilación nativa, total_worker_time puede no ser exacto si varias ejecuciones tardan menos de 1 milisegundo.
last_worker_time	bigint	Tiempo de CPU, en microsegundos, consumido la última vez que se ejecutó la función. ¹
min_worker_time	bigint	Tiempo mínimo de CPU, en microsegundos, que esta función haya consumido durante una sola ejecución. ¹
max_worker_time	bigint	Tiempo máximo de CPU, en microsegundos, que esta función haya consumido durante una sola ejecución. ¹
total_physical_reads	bigint	Número total de lecturas físicas realizadas por las ejecuciones de esta función desde su compilación. Será siempre 0 al consultar una tabla optimizada para memoria.
last_physical_reads	bigint	Número de lecturas físicas realizadas la última vez que se ejecutó la función. Será siempre 0 al consultar una tabla optimizada para memoria.
min_physical_reads	bigint	Número mínimo de lecturas físicas que ha realizado esta función durante una ejecución. Será siempre 0 al consultar una tabla optimizada para memoria.
max_physical_reads	bigint	Número máximo de lecturas físicas que ha realizado este plan durante una ejecución. Será siempre 0 al consultar una tabla optimizada para memoria.
total_logical_writes	bigint	Número total de escrituras lógicas realizadas por las ejecuciones de esta función desde su compilación. Será siempre 0 al consultar una tabla optimizada para memoria.
last_logical_writes	bigint	Número de páginas del grupo de búferes desfasadas la última vez que se ejecutó el plan. Si una página ya está desfasada (modificada) no se cuenta ninguna escritura. Será siempre 0 al consultar una tabla optimizada para memoria.
min_logical_writes	bigint	Número mínimo de escrituras lógicas que ha realizado esta función durante una ejecución. Será siempre 0 al consultar una tabla optimizada para memoria.
max_logical_writes	bigint	Número máximo de escrituras lógicas que ha realizado esta función durante una ejecución. Será siempre 0 al consultar una tabla optimizada para memoria.
total_logical_reads	bigint	Número total de lecturas lógicas realizadas por las ejecuciones de esta función desde su compilación. Será siempre 0 al consultar una tabla optimizada para memoria.
last_logical_reads	bigint	Número de lecturas lógicas realizadas la última vez que se ejecutó la función. Será siempre 0 al consultar una tabla optimizada para memoria.
min_logical_reads	bigint	Número mínimo de lecturas lógicas que ha realizado esta función durante una ejecución. Será siempre 0 al consultar una tabla optimizada para memoria.
max_logical_reads	bigint	Número máximo de lecturas lógicas que ha realizado esta función durante una ejecución. Será siempre 0 al consultar una tabla optimizada para memoria.
total_elapsed_time	bigint	Tiempo total transcurrido, en microsegundos, para ejecuciones completadas de esta función.
last_elapsed_time	bigint	Tiempo transcurrido, en microsegundos, hasta la finalización de la ejecución más reciente de esta función.
min_elapsed_time	bigint	Tiempo mínimo transcurrido, en microsegundos, para cualquier ejecución completada de esta función.
max_elapsed_time	bigint	Tiempo máximo transcurrido, en microsegundos, para cualquier ejecución completada de esta función.
total_page_server_reads	bigint	Número total de lecturas del servidor de páginas realizadas por las ejecuciones de esta función desde su compilación. Se aplica a: Hiperescala de Azure SQL Database.
last_page_server_reads	bigint	Número de lecturas del servidor de páginas realizadas la última vez que se ejecutó la función. Se aplica a: Hiperescala de Azure SQL Database.
min_page_server_reads	bigint	Número mínimo de lecturas del servidor de páginas que ha realizado esta función durante una ejecución. Se aplica a: Hiperescala de Azure SQL Database.
max_page_server_reads	bigint	Número máximo de lecturas del servidor de páginas que ha realizado esta función durante una ejecución. Se aplica a: Hiperescala de Azure SQL Database.

Permisos

En SQL Server y SQL Managed Instance, requiere el permiso VIEW SERVER STATE.

En los objetivos de servicio Básico, S0 y S1 de SQL Database y para bases de datos en grupos elásticos, se requiere la cuenta de administrador del servidor, la cuenta de administrador Microsoft Entra o la pertenencia al ##MS_ServerStateReader##rol del servidor. En el resto de objetivos del servicio de SQL Database, se requiere el permiso VIEW DATABASE STATE en la base de datos o la pertenencia en el rol del servidor ##MS_ServerStateReader##.

Permisos para SQL Server 2022 y versiones posteriores

Requiere el permiso VER ESTADO DE RENDIMIENTO DEL SERVIDOR en el servidor.

Ejemplos

En el ejemplo siguiente se devuelve información acerca de las diez principales funciones identificadas por el promedio de tiempo transcurrido.

SELECT TOP 10 d.object_id, d.database_id, OBJECT_NAME(object_id, database_id) 'function name',   
    d.cached_time, d.last_execution_time, d.total_elapsed_time,  
    d.total_elapsed_time/d.execution_count AS [avg_elapsed_time],  
    d.last_elapsed_time, d.execution_count  
FROM sys.dm_exec_function_stats AS d  
ORDER BY [total_worker_time] DESC;

Consulte también

Funciones y vistas de administración dinámica relacionadas con ejecuciones (Transact-SQL)
sys.dm_exec_sql_text (Transact-SQL)
sys.dm_exec_query_stats (Transact-SQL)

sys.dm_exec_trigger_stats (Transact-SQL)
sys.dm_exec_procedure_stats (Transact-SQL)