sys.dm_exec_xml_handles (Transact-SQL)
platí pro:
SQL Serverazure SQL 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 | Popis |
|---|---|---|
| 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 použít společně s sql_handle, statement_end_offseta funkcí sys.dm_exec_sql_text dynamické správy k načtení aktuálně spouštěcí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 použít společně s sql_handle, statement_start_offseta funkcí sys.dm_exec_sql_text dynamické správy k načtení aktuálně spouštěcího příkazu pro požadavek. |
| creation_time | data a času | Č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 volání sp_xml_preparedocument. |
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.
Dovolení
Vyžaduje na serveru oprávnění ZOBRAZIT STAV SERVERU, aby se zobrazily všechny relace nebo ID relací, které nejsou vlastníkem volajícího. 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 oprávnění ZOBRAZIT STAV VÝKONU SERVERU na serveru.
Příklady
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)