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)