sys.dm_exec_xml_handles (Transact-SQL)
Gibt Informationen zu aktiven Handles zurück, die von sp_xml_preparedocument geöffnet wurden.
Syntax
dm_exec_xml_handles (session_id | 0 )
Arguments
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_preparedocument zurü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_offset und 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_offset und 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_preparedocument zurü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.
Beispiele
Im folgenden Beispiel werden alle aktiven Handles ausgewählt.
select * from sys.dm_exec_xml_handles(0)