sys.dm_exec_xml_handles (Transact-SQL)

Platí na:SQL ServerAzureSQL Managed Instance

Vrátí informace o aktivních popisovačích, které byly otevřeny sp_xml_preparedocument.

Syntax

  
dm_exec_xml_handles (session_id | 0 )  

Argumenty

session_id | 0,
ID relace. Pokud je zadán session_id, vrátí tato funkce informace o popisovačích XML v zadané relaci.

Pokud je zadána hodnota 0, vrátí funkce informace o všech popisovačích XML pro všechny relace.

Vrácená tabulka

Název sloupce	Datový typ	Description
session_id	int	ID relace relace, která obsahuje tento popisovač dokumentu XML.
document_id	int	ID popisovače dokumentu XML vrácené sp_xml_preparedocument.
namespace_document_id	int	Interní ID popisovače používané pro přidružený dokument oboru názvů, který byl předán jako třetí parametr sp_xml_preparedocument. Null, pokud neexistuje žádný dokument oboru názvů.
sql_handle	varbinary(64)	Popisovač textu kódu SQL, ve kterém byl popisovač definován.
statement_start_offset	int	Počet znaků do aktuálně spuštěné dávky nebo uložené procedury, ve které dochází k volání sp_xml_preparedocument. Lze jej použít společně s funkcí sql_handle, statement_end_offset a dynamické správy sys.dm_exec_sql_text k získání aktuálně vykonávaného příkazu pro požadavek.
statement_end_offset	int	Počet znaků do aktuálně spuštěné dávky nebo uložené procedury, ve které dochází k volání sp_xml_preparedocument. Lze jej použít společně s funkcí sql_handle, statement_start_offset a dynamické správy sys.dm_exec_sql_text k získání aktuálně vykonávaného příkazu pro požadavek.
creation_time	datetime	Časové razítko při sp_xml_preparedocument bylo volána.
original_document_size_bytes	bigint	Velikost neparsovaného dokumentu XML v bajtech
original_namespace_document_size_bytes	bigint	Velikost dokumentu neparsovaného oboru názvů XML v bajtech Null, pokud neexistuje žádný dokument oboru názvů.
num_openxml_calls	bigint	Počet volání OPENXML pomocí tohoto popisovače dokumentu
row_count	bigint	Počet řádků vrácených všemi předchozími voláními OPENXML pro tento popisovač dokumentu
dormant_duration_ms	bigint	Milisekundy od posledního volání OPENXML. Pokud není volán OPENXML, vrátí milisekundy od sp_xml_preparedocument volání.

Poznámky

Doba života sql_handles použitá k načtení textu SQL, který spustil volání sp_xml_preparedocument oživuje plán uložený v mezipaměti použitý k provedení dotazu. Pokud text dotazu není v mezipaměti k dispozici, data nelze načíst pomocí informací uvedených ve výsledku funkce. K tomu může dojít v případě, že používáte mnoho velkých dávek.

Povolení

Vyžaduje VIEW povolení SERVER STATE na serveru pro zobrazení všech relací nebo ID relací, které volající nevlastní. Volající může vždy zobrazit data pro své vlastní ID aktuální relace.

Oprávnění pro SQL Server 2022 a novější

Vyžaduje VIEW oprávnění SERVER PERFORMANCE STATE na serveru.

Examples

Následující příklad vybere všechny aktivní popisovače.

SELECT * FROM sys.dm_exec_xml_handles(0);  

Viz také

Zobrazení a funkce dynamické správy (Transact-SQL)
zobrazení a funkce související se spouštěním dynamické správy (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)