Freigeben über


sys.dm_exec_xml_handles (Transact-SQL)

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 sql_handle, statement_end_offsetund der dynamischen Verwaltungsfunktion sys.dm_exec_sql_text zum Abrufen der zurzeit ausgeführten Anweisung für die Anforderung verwendet werden.
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.

Hinweise

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)