sys.dm_exec_function_stats (Transact-SQL)
Область применения:
SQL Server 2016 (13.x) и более поздних версий База данных SQL Azure Управляемый экземпляр SQL Azure
Возвращает статистическую статистику производительности для кэшированных функций. Представление возвращает по одной строке для каждого кэшированного плана функции, а время существования строки — до тех пор, пока функция остается кэшированной. При удалении функции из кэша соответствующая строка удаляется из этого представления. В то время событие трассировки sql статистики производительности вызывается аналогично sys.dm_exec_query_stats. Возвращает сведения о скалярных функциях, включая функции в памяти и скалярные функции CLR. Не возвращает сведения о табличных функциях и о скалярных функциях, которые встраиваются в скалярную структуру UDF.
В База данных SQL Azure динамические административные представления не могут предоставлять сведения, влияющие на доступность базы данных или предоставление сведений о других базах данных, к которым пользователь имеет доступ. Чтобы избежать предоставления этой информации, отфильтровывается каждая строка, содержащая данные, которые не принадлежат подключену клиенту.
Примечание.
Результаты sys.dm_exec_function_stats могут отличаться в зависимости от каждого выполнения, так как данные отражают только завершенные запросы, а не те, которые еще не выполнялись.
| Имя столбца | Тип данных | Description |
|---|---|---|
| database_id | int | Идентификатор базы данных, в которой находится функция. В База данных SQL Azure значения уникальны в одной базе данных или эластичном пуле, но не в логическом сервере. |
| 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 | Общий объем времени ЦП в микросекундах, который использовался выполнением этой функции, так как она была скомпилирована. Для скомпилированных в собственном коде функций total_worker_time может не быть точным, если многие выполнения занимают менее 1 миллисекунда. |
| last_worker_time | bigint | Время ЦП в микросекундах, которое использовалось при последнем выполнении функции. 1 |
| min_worker_time | bigint | Минимальное время ЦП в микросекундах, которое эта функция когда-либо использовала во время одного выполнения. 1 |
| max_worker_time | bigint | Максимальное время ЦП в микросекундах, которое эта функция когда-либо использовала во время одного выполнения. 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 | Общее количество операций чтения сервера страницы, выполняемого выполнением этой функции, так как она была скомпилирована. Область применения: База данных SQL Azure гипермасштабирование. |
| last_page_server_reads | bigint | Число операций чтения сервера страницы при последнем выполнении функции. Область применения: База данных SQL Azure гипермасштабирование. |
| min_page_server_reads | bigint | Минимальное количество серверов страниц считывает, что эта функция когда-либо выполнялась во время одного выполнения. Область применения: База данных SQL Azure гипермасштабирование. |
| max_page_server_reads | bigint | Максимальное количество серверов страницы считывает, что эта функция когда-либо выполнялась во время одного выполнения. Область применения: База данных SQL Azure гипермасштабирование. |
Разрешения
На SQL Server и управляемом экземпляре SQL необходимо разрешение VIEW SERVER STATE.
Для целей службы База данных SQL Basic, 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)