sys.dm_exec_xml_handles (Transact-SQL)
gäller för:
SQL ServerAzure SQL Managed Instance
Returnerar information om aktiva referenser som har öppnats av sp_xml_preparedocument.
Syntax
dm_exec_xml_handles (session_id | 0 )
Argument
session_id | 0,
ID för sessionen. Om session_id anges returnerar den här funktionen information om XML-referenser i den angivna sessionen.
Om 0 anges returnerar funktionen information om alla XML-referenser för alla sessioner.
Tabell returnerad
| Kolumnnamn | Datatyp | Beskrivning |
|---|---|---|
| session_id | int | Sessions-ID för den session som innehåller det här XML-dokumenthandtaget. |
| document_id | int | XML-dokumenthandtags-ID som returneras av sp_xml_preparedocument. |
| namespace_document_id | int | Internt referens-ID som används för det associerade namnområdesdokumentet som har skickats som den tredje parametern till sp_xml_preparedocument. NULL om det inte finns något namnområdesdokument. |
| sql_handle | varbinary(64) | Hantera till texten i SQL-koden där handtaget har definierats. |
| statement_start_offset | int | Antal tecken i den batch som körs för tillfället eller den lagrade procedur där sp_xml_preparedocument-anropet inträffar. Kan användas tillsammans med sql_handle, statement_end_offsetoch funktionen sys.dm_exec_sql_text dynamisk hantering för att hämta instruktionen som körs för begäran. |
| statement_end_offset | int | Antal tecken i den batch som körs för tillfället eller den lagrade procedur där sp_xml_preparedocument-anropet inträffar. Kan användas tillsammans med sql_handle, statement_start_offsetoch funktionen sys.dm_exec_sql_text dynamisk hantering för att hämta instruktionen som körs för tillfället för begäran. |
| creation_time | datetime | Tidsstämpel när sp_xml_preparedocument anropades. |
| original_document_size_bytes | bigint | Storleken på det ohörda XML-dokumentet i byte. |
| original_namespace_document_size_bytes | bigint | Storleken på det ohörda XML-namnområdesdokumentet i byte. NULL om det inte finns något namnområdesdokument. |
| num_openxml_calls | bigint | Antal OPENXML-anrop med det här dokumenthandtaget. |
| row_count | bigint | Antal rader som returneras av alla tidigare OPENXML-anrop för det här dokumenthandtaget. |
| dormant_duration_ms | bigint | Millisekunder sedan det senaste OPENXML-anropet. Om OPENXML inte har anropats returnerar millisekunder sedan sp_xml_preparedocument-anropet. |
Anmärkningar
Livslängden för sql_handles som används för att hämta SQL-texten som körde ett anrop för att sp_xml_preparedocument överskrider den cachelagrade plan som användes för att köra frågan. Om frågetexten inte är tillgänglig i cacheminnet går det inte att hämta data med hjälp av informationen i funktionsresultatet. Detta kan inträffa om du kör många stora batchar.
Behörigheter
Kräver behörigheten VISA SERVERTILLSTÅND på servern för att se alla sessioner eller sessions-ID:t som inte ägs av anroparen. En anropare kan alltid se data för sitt eget aktuella sessions-ID.
Behörigheter för SQL Server 2022 och senare
Kräver BEHÖRIGHET FÖR VISNINGSSERVERNS PRESTANDATILLSTÅND på servern.
Exempel
I följande exempel väljs alla aktiva referenser.
SELECT * FROM sys.dm_exec_xml_handles(0);
Se även
Dynamiska hanteringsvyer och funktioner (Transact-SQL)
körningsrelaterade vyer och funktioner för dynamisk hantering (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)