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)