sys.dm_exec_xml_handles (Transact-SQL)

A következőkre vonatkozik:SQL ServerFelügyelt Azure SQL-példány

A sp_xml_preparedocumentáltal megnyitott aktív leírók adatait adja vissza.

Szintaxis

  
dm_exec_xml_handles (session_id | 0 )  

Érvek

session_id | 0,
A munkamenet azonosítója. Ha session_id van megadva, ez a függvény a megadott munkamenet XML-leíróiról ad vissza információkat.

Ha 0 van megadva, a függvény az összes munkamenet összes XML-leírójának adatait adja vissza.

Visszaadott tábla

Oszlop neve	Adattípus	Leírás
session_id		Az XML-dokumentumleírót tartalmazó munkamenet munkamenet-azonosítója.
document_id		A sp_xml_preparedocumentáltal visszaadott XML-dokumentumkezelő azonosítója.
namespace_document_id		A társított névtérdokumentumhoz használt belső leíróazonosító, amely harmadik paraméterként lett átadva sp_xml_preparedocument. NULL érték, ha nincs névtérdokumentum.
sql_handle	varbinary(64)	Fogópont annak az SQL-kódnak a szövegéhez, amelyben a leíró definiálva van.
statement_start_offset		A jelenleg futó kötegbe vagy tárolt eljárásba tartozó karakterek száma, amelyen a sp_xml_preparedocument hívás történik. A sql_handle, a statement_end_offsetés a sys.dm_exec_sql_text dinamikus felügyeleti függvénnyel együtt használható a kérés aktuális végrehajtási utasításának lekéréséhez.
statement_end_offset		A jelenleg futó kötegbe vagy tárolt eljárásba tartozó karakterek száma, amelyen a sp_xml_preparedocument hívás történik. A sql_handle, a statement_start_offsetés a sys.dm_exec_sql_text dinamikus felügyeleti függvénnyel együtt használható a kérés aktuális végrehajtási utasításának lekéréséhez.
creation_time	datetime	Időbélyeg sp_xml_preparedocument hívásakor.
original_document_size_bytes	bigint	A nem tagolt XML-dokumentum mérete bájtban.
original_namespace_document_size_bytes	bigint	A nem tagolt XML-névtérdokumentum mérete bájtban. NULL érték, ha nincs névtérdokumentum.
num_openxml_calls	bigint	A dokumentumleíróval rendelkező OPENXML-hívások száma.
row_count	bigint	A dokumentumleíró összes korábbi OPENXML-hívása által visszaadott sorok száma.
dormant_duration_ms	bigint	Ezredmásodperc a legutóbbi OPENXML-hívás óta. Ha az OPENXML nem lett meghívva, ezredmásodpercet ad vissza a sp_xml_preparedocument hívás óta.

Megjegyzések

A sql_handles élettartama, amely a hívást végrehajtó SQL-szöveg lekérésére szolgál, sp_xml_preparedocument túllépi a lekérdezés végrehajtásához használt gyorsítótáras tervet. Ha a lekérdezés szövege nem érhető el a gyorsítótárban, az adatok nem kérhetők le a függvény eredményében megadott információk alapján. Ez akkor fordulhat elő, ha sok nagy köteget futtat.

Engedélyek

A KISZOLGÁLÓ ÁLLAPOTának megtekintése engedély szükséges a kiszolgálón az összes olyan munkamenet vagy munkamenet-azonosító megtekintéséhez, amely nem a hívó tulajdonában van. A hívók mindig láthatják a saját aktuális munkamenet-azonosítójuk adatait.

Engedélyek az SQL Server 2022-hez és újabb verziókhoz

A KISZOLGÁLÓ TELJESÍTMÉNYÁLLAPOTÁNAK MEGTEKINTÉSE engedélyre van szükség a kiszolgálón.

Példák

Az alábbi példa az összes aktív fogópontot kijelöli.

SELECT * FROM sys.dm_exec_xml_handles(0);  

Lásd még:

dinamikus felügyeleti nézetek és függvények (Transact-SQL)
végrehajtással kapcsolatos dinamikus felügyeleti nézetek és függvények (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)