sys.dm_exec_xml_handles (Transact-SQL)
Gilt für:
SQL ServerAzure 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 die Daten für ihre eigene aktuelle Sitzungs-ID immer 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)