sys.dm_exec_xml_handles (Transact-SQL)

Artikel
04/26/2023

Gilt für:SQL Server Azure SQL Managed Instance

Gibt Informationen zu aktiven Handles zurück, die von sp_xml_preparedocumentgeöffnet wurden.

Syntax

  
dm_exec_xml_handles (session_id | 0 )

Argumente

session_id | 0,
ID der Sitzung. Wenn session_id angegeben wird, gibt die Funktion Informationen zu XML-Handles in der angegebenen Sitzung zurück.

Wenn 0 angegeben wird, gibt die Funktion Informationen zu allen XML-Handles für alle Sitzungen zurück.

Zurückgegebene Tabelle

Spaltenname	Datentyp	BESCHREIBUNG
session_id	int	Sitzungs-ID der Sitzung, die dieses XML-Dokumenthandle verwaltet.
document_id	int	Von sp_xml_preparedocumentzurückgegebene ID eines XML-Dokumenthandles.
namespace_document_id	int	Interne Handle-ID für das zugeordnete Namespacedokument, das als dritter Parameter an sp_xml_preparedocumentübergeben wurde. NULL, wenn kein Namespacedokument vorhanden ist.
sql_handle	varbinary(64)	Handle für den Text des SQL-Codes, in dem das Handle definiert wurde.
statement_start_offset	int	Die Anzahl von Zeichen, nach der der Aufruf von sp_xml_preparedocument im zurzeit ausgeführten Batch oder in der gespeicherten Prozedur auftritt. Kann zusammen mit dem sql_handle, dem statement_end_offset und der dynamischen Verwaltungsfunktion sys.dm_exec_sql_text verwendet werden, um die aktuell ausgeführte Anweisung für die Anforderung abzurufen.
statement_end_offset	int	Die Anzahl von Zeichen, nach der der Aufruf von sp_xml_preparedocument im zurzeit ausgeführten Batch oder in der gespeicherten Prozedur auftritt. Kann zusammen mit sql_handle, statement_start_offsetund der dynamischen Verwaltungsfunktion sys.dm_exec_sql_text zum Abrufen der zurzeit ausgeführten Anweisung für die Anforderung verwendet werden.
creation_time	datetime	Timestamp des Aufrufs von sp_xml_preparedocument .
original_document_size_bytes	bigint	Größe des nicht analysierten XML-Dokuments in Bytes.
original_namespace_document_size_bytes	bigint	Größe des nicht analysierten XML-Namespacedokuments in Bytes. NULL, wenn kein Namespacedokument vorhanden ist.
num_openxml_calls	bigint	Die Anzahl von OPENXML-Aufrufen mit diesem Dokumenthandle.
row_count	bigint	Die Anzahl von Zeilen, die von allen vorherigen OPENXML-Aufrufen für dieses Dokumenthandle zurückgegeben wurden.
dormant_duration_ms	bigint	Millisekunden seit dem letzten OPENXML-Aufruf. Falls OPENXML nicht aufgerufen wurde, werden die Millisekunden seit dem Aufruf von sp_xml_preparedocumentzurückgegeben.

Bemerkungen

Die Lebensdauer von sql_handle -Werten, mit denen der SQL-Text abgerufen wird, in dem ein Aufruf von sp_xml_preparedocument ausgeführt wird, überdauert den zwischengespeicherten Plan, nach dem die Abfrage ausgeführt wird. Ist der Abfragetext nicht im Cache verfügbar, können die Daten nicht mithilfe der Informationen im Funktionsergebnis abgerufen werden. Dies kann eintreten, wenn Sie viele umfangreiche Batches ausführen.

Berechtigungen

Erfordert die VIEW SERVER STATE-Berechtigung auf dem Server, um alle Sitzungen oder Sitzungs-IDs anzuzeigen, die nicht im Besitz des Aufrufers sind. Ein Aufrufer kann immer die Daten für seine eigene aktuelle Sitzungs-ID anzeigen.

Berechtigungen für SQL Server 2022 und höher

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

Beispiele

Im folgenden Beispiel werden alle aktiven Handles ausgewählt.

SELECT * FROM sys.dm_exec_xml_handles(0);

Weitere Informationen

Dynamische Verwaltungssichten und Funktionen (Transact-SQL)
Dynamische Verwaltungssichten und -funktionen im Zusammenhang mit der Ausführung (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)