sys.dm_exec_query_plan_stats (Transact-SQL)

Artikel
07/15/2024

Gilt für: SQL Server 2019 (15.x) Azure SQL-Datenbank Azure SQL Managed Instance

Gibt das Äquivalent des letzten bekannten tatsächlichen Ausführungsplans für einen zuvor zwischengespeicherten Abfrageplan zurück.

Syntax

sys.dm_exec_query_plan_stats ( plan_handle )

Argumente

plan_handle

Ein Token, das einen Abfrageausführungsplan für einen Batch eindeutig identifiziert, der ausgeführt wurde und dessen Plan sich im Plancache befindet, oder der derzeit ausgeführt wird. plan_handle ist varbinary(64)

plan_handle kann aus den folgenden dynamischen Verwaltungsobjekten abgerufen werden:

Zurückgegebene Tabelle

Spaltenname	Datentyp	Beschreibung
dbid	smallint	ID der Kontextdatenbank, die gültig war, als die diesem Plan entsprechende Transact-SQL-Anweisung kompiliert wurde. Für Ad-hoc-Anweisungen und vorbereitete SQL-Anweisungen, die ID der Datenbank, in der die Anweisungen kompiliert wurden. Die Spalte lässt NULL-Werte zu.
objectid	int	ID des Objekts (z. B. gespeicherte Prozedur oder benutzerdefinierte Funktion) für diesen Abfrageplan. Für Ad-hoc- und vorbereitete Batches entspricht diese Spalte dem Wert NULL. Die Spalte lässt NULL-Werte zu.
Zahl	smallint	Gespeicherte Prozedur mit ganzer Zahl. Eine Gruppe von Prozeduren für die orders -Anwendung kann z. B. die Namen orderproc;1, orderproc;2usw. haben. Für Ad-hoc- und vorbereitete Batches entspricht diese Spalte dem Wert NULL. Die Spalte lässt NULL-Werte zu.
encrypted	bit	Zeigt an, ob die entsprechende Prozedur verschlüsselt ist. 0 = nicht verschlüsselt 1 = verschlüsselt NULL-Werte sind in der Spalte nicht zulässig.
query_plan	xml	Enthält die letzte bekannte Laufzeit-Showplan-Darstellung des tatsächlichen Abfrageausführungsplans, der mit plan_handle angegeben ist. Der Showplan liegt im XML-Format vor. Für jeden Batch, der z. B. Ad-hoc-Transact-SQL-Anweisungen, Aufrufe von gespeicherten Prozeduren sowie benutzerdefinierte Funktionsaufrufe enthält, wird jeweils ein Plan generiert. Die Spalte lässt NULL-Werte zu.

Hinweise

Dies ist ein Opt-in-Feature. Verwenden Sie zum Aktivieren auf Serverebene das Ablaufverfolgungsflag 2451. Um dies auf Datenbankebene zu aktivieren, verwenden Sie die Option LAST_QUERY_PLAN_STATS in ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL).

Diese Systemfunktion arbeitet im Rahmen der leichtgewichtigen Infrastruktur für die Erstellung von Abfrageausführungsstatistiken. Weitere Informationen finden Sie unter Profilerstellungsinfrastruktur für Abfragen.

Der von sys.dm_exec_query_plan_stats ausgegebene Showplan enthält die folgenden Informationen:

Alle Kompilierungszeitinformationen, die im zwischengespeicherten Plan gefunden wurden
Laufzeitinformationen, z. B. die tatsächliche Anzahl von Zeilen pro Operator, die gesamte CPU-Zeit und die Ausführungszeit der Abfrage, Überlaufwarnungen, tatsächliche DOP, maximal genutzter Arbeitsspeicher und gewährtem Arbeitsspeicher

Unter den folgenden Bedingungen wird in der Spalte query_plan der Rückgabetabelle für sys.dm_exec_query_plan_stats eine Ausgabe von Showplan zurückgegeben, die einem tatsächlichen Ausführungsplan entspricht:

Der Plan befindet sich in sys.dm_exec_cached_plans.

AND
Die ausgeführte Abfrage ist komplex oder ressourcenaufwendig.

Unter den folgenden Bedingungen wird in der Spalte query_plan der zurückgegebenen Tabelle für sys.dm_exec_query_plan_stats eine vereinfachte ¹ Showplan-Ausgabe zurückgegeben:

Der Plan befindet sich in sys.dm_exec_cached_plans.

AND
Die Abfrage ist einfach genug, in der Regel als Teil einer OLTP-Workload kategorisiert.

¹ Bezieht sich auf einen Showplan, der nur den Stammknotenoperator (SELECT) enthält.

Unter den folgenden Bedingungen wird keine Ausgabe von sys.dm_exec_query_plan_stats zurückgegeben:

Der Abfrageplan, der durch die Verwendung von plan_handle angegeben wird, wurde aus dem Plancache verdrängt.

ODER
Der Abfrageplan konnte nicht an erster Stelle zwischengespeichert werden. Weitere Informationen finden Sie unter Zwischenspeicherung und Wiederverwendung von Ausführungsplänen.

Hinweis

Eine Beschränkung in der Anzahl der im xml-Datentyp zulässigen verschachtelten Ebenen bedeutet, dass sys.dm_exec_query_plan keine Abfragepläne zurückgeben kann, die 128 Ebenen verschachtelter Elemente erfüllen oder überschreiten. In früheren Versionen von SQL Server verhinderte diese Bedingung das Zurückgeben des Abfrageplans, wobei der Fehler 6335 generiert wurde. In SQL Server 2005 (9.x) Service Pack 2 und höheren Versionen gibt die query_plan-Spalte NULL zurück.

Berechtigungen

Erfordert die VIEW SERVER STATE-Berechtigung auf dem Server.

Berechtigungen für SQL Server 2022 und höher

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

Beispiele

A. Sehen Sie sich den letzten bekannten tatsächlichen Abfrageausführungsplan für einen bestimmten zwischengespeicherten Plan an

Das folgende Beispiel fragt sys.dm_exec_cached_plans ab, um den entsprechende Plan zu suchen und die plan_handle aus der Ausgabe zu kopieren.

SELECT * FROM sys.dm_exec_cached_plans;
GO

Um dann den letzten bekannten tatsächlichen Abfrageausführungsplan zu erhalten, verwenden Sie das kopierte plan_handle mit der Systemfunktion sys.dm_exec_query_plan_stats.

SELECT * FROM sys.dm_exec_query_plan_stats(< copied plan_handle >);
GO

B. Sehen Sie sich den letzten bekannten tatsächlichen Abfrageausführungsplan für alle zwischengespeicherten Pläne an

SELECT *
FROM sys.dm_exec_cached_plans AS cp
CROSS APPLY sys.dm_exec_sql_text(plan_handle) AS st
CROSS APPLY sys.dm_exec_query_plan_stats(plan_handle) AS qps;
GO

C. Sehen Sie sich den letzten bekannten tatsächlichen Abfrageausführungsplan für einen bestimmten zwischengespeicherten Plan und Abfragetext an

SELECT *
FROM sys.dm_exec_cached_plans AS cp
CROSS APPLY sys.dm_exec_sql_text(plan_handle) AS st
CROSS APPLY sys.dm_exec_query_plan_stats(plan_handle) AS qps
WHERE st.text LIKE 'SELECT * FROM Person.Person%';
GO

D: Sehen Sie sich zwischengespeicherte Ereignisse für Trigger an

SELECT *
FROM sys.dm_exec_cached_plans
CROSS APPLY sys.dm_exec_query_plan_stats(plan_handle)
WHERE objtype ='Trigger';
GO

Freigeben über