sys.dm_exec_function_stats (Transact-SQL)

适用范围:SQL Server 2016 (13.x) 及更高版本 Azure SQL 数据库 Azure SQL 托管实例

返回缓存函数的聚合性能统计信息。 该视图为每个缓存的函数计划都返回一行,行的生存期与函数保持缓存状态的时间一样长。 在从缓存中删除函数时,也将从该视图中删除对应行。 此时,将引发类似于 sys.dm_exec_query_stats 的性能统计信息 SQL 跟踪事件。 返回有关标量函数的信息,包括内存中函数和 CLR 标量函数。 不返回有关表值函数以及使用标量 UDF 内联内联的标量函数的信息。

在 Azure SQL 数据库中,动态管理视图不能公开将影响数据库包含的信息,也不能公开有关用户可以访问的其他数据库的信息。 为了避免暴露此信息,包含不属于所连接租户的数据的每行都会被筛选出。

注意

sys.dm_exec_function_stats 的结果可能因每次执行而异,因为数据仅反映已完成的查询,而不反映仍在进行中的查询。

列名称 数据类型 描述
database_id int 函数所在的数据库 ID。

在 Azure SQL 数据库中,这些值在单一数据库或弹性池中是唯一的,但在逻辑服务器中不是唯一的。
object_id int 函数的对象标识号。
type char(2) 对象类型:FN = 标量值函数
type_desc nvarchar(60) 对象类型的说明:SQL_SCALAR_FUNCTION
sql_handle varbinary(64) 这可用于与从此函数内执行的 sys.dm_exec_query_stats 中的查询关联。
plan_handle varbinary(64) 内存中计划的标识符。 该标识符是瞬态的,仅当计划保留在缓存中时,它才保持不变。 此值可与 sys.dm_exec_cached_plans 动态管理视图一起使用。

当本机编译的函数查询内存优化表时,此项将始终为 0x000。
cached_time datetime 函数添加到缓存的时间。
last_execution_time datetime 上次执行函数的时间。
execution_count bigint 函数自上次编译以来所执行的次数。
total_worker_time bigint 此函数自编译以来执行所用的 CPU 时间总量(微秒)。

对于本机编译的函数,如果许多执行所用的时间都不到 1 毫秒,则 total_worker_time 可能不精确。
last_worker_time bigint 上次执行函数所用的 CPU 时间(微秒)。 1
min_worker_time bigint 此函数在单个执行期间消耗的最短 CPU 时间(微秒)。 1
max_worker_time bigint 此函数在单个执行期间消耗的最长 CPU 时间(微秒)。 1
total_physical_reads bigint 此函数自编译后在执行期间所执行的物理读取总次数。

当查询内存优化的表时,此项将始终为 0。
last_physical_reads bigint 上次执行函数时所执行的物理读取次数。

当查询内存优化的表时,此项将始终为 0。
min_physical_reads bigint 此函数在单个执行期间所执行的最少物理读取次数。

当查询内存优化的表时,此项将始终为 0。
max_physical_reads bigint 此函数在单个执行期间所执行的最多物理读取次数。

当查询内存优化的表时,此项将始终为 0。
total_logical_writes bigint 此函数自编译后在执行期间所执行的逻辑写入总次数。

当查询内存优化的表时,此项将始终为 0。
last_logical_writes bigint 上次执行计划时变脏的缓冲池页数。 如果页已变脏(已修改),则不计入写次数。

当查询内存优化的表时,此项将始终为 0。
min_logical_writes bigint 此函数在单个执行期间所执行的最少逻辑写入次数。

当查询内存优化的表时,此项将始终为 0。
max_logical_writes bigint 此函数在单个执行期间所执行的最多逻辑写入次数。

当查询内存优化的表时,此项将始终为 0。
total_logical_reads bigint 此函数自编译后在执行期间所执行的逻辑读取总次数。

当查询内存优化的表时,此项将始终为 0。
last_logical_reads bigint 上次执行函数时所执行的逻辑读取次数。

当查询内存优化的表时,此项将始终为 0。
min_logical_reads bigint 此函数在单个执行期间所执行的最少逻辑读取次数。

当查询内存优化的表时,此项将始终为 0。
max_logical_reads bigint 此函数在单个执行期间所执行的最多逻辑读取次数。

当查询内存优化的表时,此项将始终为 0。
total_elapsed_time bigint 完成此函数的执行所用的总时间(微秒)。
last_elapsed_time bigint 最近完成此函数的执行所用的时间(微秒)。
min_elapsed_time bigint 完成此函数的任何执行所用的最短时间(微秒)。
max_elapsed_time bigint 完成此函数的任何执行所用的最长时间(微秒)。
total_page_server_reads bigint 此函数自编译后在执行期间所执行的页面服务器读取总次数。

适用于:Azure SQL 数据库超大规模。
last_page_server_reads bigint 上次执行函数时所执行的页面服务器读取次数。

适用于:Azure SQL 数据库超大规模。
min_page_server_reads bigint 此函数在单个执行期间所执行的最少页面服务器读取次数。

适用于:Azure SQL 数据库超大规模。
max_page_server_reads bigint 此函数在单个执行期间所执行的最多页面服务器读取次数。

适用于:Azure SQL 数据库超大规模。

权限

对于 SQL Server 和 SQL 托管实例,需要 VIEW SERVER STATE 权限。

在 SQL 数据库“基本”、“S0”和“S1”服务目标中,对于“弹性池”中的数据库,服务器管理员帐户、Microsoft Entra 管理员帐户或 ##MS_ServerStateReader## 服务器角色中的成员身份为必填项。 对于所有其他 SQL 数据库服务目标,需要数据库的 VIEW DATABASE STATE 权限或 ##MS_ServerStateReader## 服务器角色中的成员身份。

SQL Server 2022 及更高版本的权限

要求对服务器具有 VIEW SERVER PERFORMANCE STATE 权限。

示例

以下示例返回有关按平均占用时间衡量的前十个函数的信息。

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;  

另请参阅

与执行有关的动态管理视图和函数 (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)