sys.dm_exec_function_stats (Transact-SQL)

Artikel
07/15/2024

Gilt für: SQL Server 2016 (13.x) und höher Azure SQL-Datenbank Azure SQL Managed Instance

Gibt die Aggregatleistungsstatistik für zwischengespeicherte Funktionen zurück. Diese Sicht gibt eine Zeile für jeden Plan der zwischengespeicherten Funktion zurück, und die Lebensdauer der Zeile entspricht der Verweildauer der Funktion im Cache. Bei Entfernung einer Funktion aus dem Cache wird die entsprechende Zeile aus dieser Sicht gelöscht. Zu diesem Zeitpunkt wird ein Leistungsstatistik-SQL-Ablaufverfolgungsereignis ausgelöst, das sys.dm_exec_query_statsentspricht. Gibt Informationen zu Skalarfunktionen zurück, einschließlich Speicherfunktionen und CLR-Skalarfunktionen. Gibt keine Informationen zu Tabellenwertfunktionen und zu Skalarfunktionen zurück, die mit Skalares UDF-Inlining eingebettet sind.

In Azure SQL-Datenbank können dynamische Verwaltungssichten keine Informationen verfügbar machen, die sich auf den Datenbankeinschluss auswirken würden oder die sich auf andere Datenbanken beziehen, auf die der Benutzer Zugriff hat. Um zu vermeiden, dass diese Informationen verfügbar gemacht werden, wird jede Zeile mit Daten, die zum verbundenen Mandanten gehören, herausgefiltert.

Hinweis

Die Ergebnisse von sys.dm_exec_function_stats können bei jeder Ausführung variieren, da die Daten nur abgeschlossene Abfragen widerspiegeln, nicht aber solche, die noch im Gange sind.

Spaltenname	Datentyp	Beschreibung
database_id	int	ID der Datenbank, in der sich die Funktion befindet. In Azure SQL-Datenbank sind die Werte innerhalb einer einzelnen Datenbank oder eines Pools für elastische Datenbanken eindeutig, aber nicht innerhalb eines logischen Servers.
object_id	int	Objekt-ID der Funktion.
type	char(2)	Typ des Objekts: FN = Skalarwertfunktionen
type_desc	nvarchar(60)	Beschreibung des Objekttyps: SQL_SCALAR_FUNCTION
sql_handle	varbinary(64)	Kann zur Korrelation mit Abfragen in sys.dm_exec_query_stats verwendet werden, die aus dieser Funktion ausgeführt wurden.
plan_handle	varbinary(64)	Bezeichner für den speicherinternen Plan. Dieser Bezeichner ist vorübergehend und bleibt nur für die Dauer der Speicherung des Plans im Cache konstant. Dieser Wert kann mit der dynamischen Verwaltungssicht sys.dm_exec_cached_plans verwendet werden. Ist immer 0x000, wenn eine systemintern kompilierte Funktion eine speicheroptimierte Tabelle abfragt.
cached_time	datetime	Der Zeitpunkt, zu dem die Funktion dem Cache hinzugefügt wurde.
last_execution_time	datetime	Der Zeitpunkt, zu dem die Funktion zuletzt ausgeführt wurde.
execution_count	bigint	Die Anzahl von Funktionsausführungen seit der letzten Kompilierung.
total_worker_time	bigint	Die CPU-Gesamtzeit (in Mikrosekunden) für Ausführungen dieser Funktion seit der Kompilierung. Wenn zahlreiche Ausführungen weniger als 1 Millisekunde dauern, wird total_worker_time bei nativ kompilierten Funktionen u.U. nicht exakt angegeben.
last_worker_time	bigint	CPU-Zeit (in Mikrosekunden) für die letzte Ausführung der Funktion. ¹
min_worker_time	bigint	Bisherige minimale CPU-Zeit (in Mikrosekunden) für eine einzelne Ausführung dieser Funktion. ¹
max_worker_time	bigint	Bisherige maximale CPU-Zeit (in Mikrosekunden) für eine einzelne Ausführung dieser Funktion. ¹
total_physical_reads	bigint	Die Gesamtanzahl physischer Lesevorgänge für Ausführungen dieser Funktion seit der Kompilierung. Ist immer 0, wenn eine speicheroptimierte Tabelle abgefragt wird.
last_physical_reads	bigint	Anzahl physischer Lesevorgänge bei der letzten Ausführung der Funktion. Ist immer 0, wenn eine speicheroptimierte Tabelle abgefragt wird.
min_physical_reads	bigint	Die bisherige minimale Anzahl physischer Lesevorgänge für eine einzelne Ausführung dieser Funktion. Ist immer 0, wenn eine speicheroptimierte Tabelle abgefragt wird.
max_physical_reads	bigint	Die bisherige maximale Anzahl physischer Lesevorgänge für eine einzelne Ausführung dieser Funktion. Ist immer 0, wenn eine speicheroptimierte Tabelle abgefragt wird.
total_logical_writes	bigint	Die Gesamtanzahl logischer Schreibvorgänge für Ausführungen dieser Funktion seit der Kompilierung. Ist immer 0, wenn eine speicheroptimierte Tabelle abgefragt wird.
last_logical_writes	bigint	Die Anzahl der Pufferpoolseiten, die seit der letzten Planausführung modifiziert wurden. Wenn eine Seite bereits modifiziert (geändert) wurde, werden keine Schreibvorgänge gezählt. Ist immer 0, wenn eine speicheroptimierte Tabelle abgefragt wird.
min_logical_writes	bigint	Die bisherige minimale Anzahl logischer Schreibvorgänge für eine einzelne Ausführung dieser Funktion. Ist immer 0, wenn eine speicheroptimierte Tabelle abgefragt wird.
max_logical_writes	bigint	Die bisherige maximale Anzahl logischer Schreibvorgänge für eine einzelne Ausführung dieser Funktion. Ist immer 0, wenn eine speicheroptimierte Tabelle abgefragt wird.
total_logical_reads	bigint	Die Gesamtanzahl logischer Lesevorgänge für Ausführungen dieser Funktion seit der Kompilierung. Ist immer 0, wenn eine speicheroptimierte Tabelle abgefragt wird.
last_logical_reads	bigint	Anzahl logischer Lesevorgänge bei der letzten Ausführung der Funktion. Ist immer 0, wenn eine speicheroptimierte Tabelle abgefragt wird.
min_logical_reads	bigint	Die bisherige minimale Anzahl logischer Lesevorgänge für eine einzelne Ausführung dieser Funktion. Ist immer 0, wenn eine speicheroptimierte Tabelle abgefragt wird.
max_logical_reads	bigint	Die bisherige maximale Anzahl logischer Lesevorgänge für eine einzelne Ausführung dieser Funktion. Ist immer 0, wenn eine speicheroptimierte Tabelle abgefragt wird.
total_elapsed_time	bigint	Insgesamt verstrichene Zeit (in Mikrosekunden) für abgeschlossene Ausführungen dieser Funktion.
last_elapsed_time	bigint	Verstrichene Zeit (in Mikrosekunden) für die letzte abgeschlossene Ausführung dieser Funktion.
min_elapsed_time	bigint	Mindestens verstrichene Zeit (in Mikrosekunden) für eine beliebige abgeschlossene Ausführung dieser Funktion.
max_elapsed_time	bigint	Maximal verstrichene Zeit (in Mikrosekunden) für eine beliebige abgeschlossene Ausführung dieser Funktion.
total_page_server_reads	bigint	Die Gesamtanzahl der Page-Server-Lesevorgänge für Ausführungen dieser Funktion seit der Kompilierung. Gilt für: Azure SQL-Datenbank Hyperscale.
last_page_server_reads	bigint	Anzahl der Page-Server-Lesevorgänge, die bei der letzten Ausführung der Funktion durchgeführt wurden. Gilt für: Azure SQL-Datenbank Hyperscale.
min_page_server_reads	bigint	Mindestanzahl der Page-Server-Lesevorgänge, die diese Funktion jemals während einer einzigen Ausführung durchgeführt hat. Gilt für: Azure SQL-Datenbank Hyperscale.
max_page_server_reads	bigint	Maximale Anzahl der Page-Server-Lesevorgänge, die diese Funktion jemals während einer einzigen Ausführung durchgeführt hat. Gilt für: Azure SQL-Datenbank Hyperscale.

Berechtigungen

Für SQL Server und SQL Managed Instance ist die VIEW SERVER STATE-Berechtigung erforderlich.

Für die SQL-Datenbank-Ziele Basic, S0 und S1 sowie für Datenbanken in Pools für elastische Datenbanken ist das Konto des Serveradministrators oder des Microsoft Entra-Administratorkontos oder die Mitgliedschaft in der ##MS_ServerStateReader## Serverrolle erforderlich. Für alle anderen SQL-Datenbank-Dienstziele ist entweder die VIEW DATABASE STATE-Berechtigung für die Datenbank oder die Mitgliedschaft in der ##MS_ServerStateReader##-Serverrolle erforderlich.

Berechtigungen für SQL Server 2022 und höher

Erfordert die VIEW SERVER PERFORMANCE STATE-Berechtigung auf dem Server.

Beispiele

Das folgende Beispiel gibt Informationen zu den 10 Funktionen mit der höchsten durchschnittlich verstrichenen Zeit zurück.

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;

Weitere Informationen

Dynamische Verwaltungssichten und -funktionen im Zusammenhang mit der Ausführung (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)

Teilen über