sys.dm_exec_xml_handles (Transact-SQL)
van toepassing op:
SQL ServerAzure SQL Managed Instance
Retourneert informatie over actieve ingangen die door sp_xml_preparedocumentzijn geopend.
Syntaxis
dm_exec_xml_handles (session_id | 0 )
Argumenten
session_id | 0,
Id van de sessie. Als session_id is opgegeven, retourneert deze functie informatie over XML-ingangen in de opgegeven sessie.
Als 0 is opgegeven, retourneert de functie informatie over alle XML-ingangen voor alle sessies.
Tabel geretourneerd
| Kolomnaam | Gegevenstype | Beschrijving |
|---|---|---|
| session_id | Sessie-id van de sessie met deze XML-documentgreep. | |
| document_id | XML-documenthandler-id geretourneerd door sp_xml_preparedocument. | |
| namespace_document_id | Interne handle-id die wordt gebruikt voor het bijbehorende naamruimtedocument dat is doorgegeven als de derde parameter aan sp_xml_preparedocument. NULL als er geen naamruimtedocument is. | |
| sql_handle | varbinary(64) | Greep naar de tekst van de SQL-code waar de handle is gedefinieerd. |
| statement_start_offset | Het aantal tekens in de momenteel uitgevoerde batch- of opgeslagen procedure waarop de sp_xml_preparedocument aanroep plaatsvindt. Kan samen met de sql_handle, de statement_end_offseten de sys.dm_exec_sql_text dynamische beheerfunctie worden gebruikt om de momenteel uitgevoerde instructie voor de aanvraag op te halen. | |
| statement_end_offset | Het aantal tekens in de momenteel uitgevoerde batch- of opgeslagen procedure waarop de sp_xml_preparedocument aanroep plaatsvindt. Kan samen met de sql_handle, de statement_start_offseten de sys.dm_exec_sql_text dynamische beheerfunctie worden gebruikt om de momenteel uitgevoerde instructie voor de aanvraag op te halen. | |
| creation_time | datum/tijd- | Tijdstempel toen sp_xml_preparedocument werd aangeroepen. |
| original_document_size_bytes | grote | De grootte van het niet-geparseerde XML-document in bytes. |
| original_namespace_document_size_bytes | grote | Grootte van het document met niet-geparseerde XML-naamruimte, in bytes. NULL als er geen naamruimtedocument is. |
| num_openxml_calls | grote | Het aantal OPENXML-aanroepen met deze documentgreep. |
| row_count | grote | Het aantal rijen dat wordt geretourneerd door alle eerdere OPENXML-aanroepen voor deze documentgreep. |
| dormant_duration_ms | grote | Milliseconden sinds de laatste OPENXML-aanroep. Als OPENXML niet is aangeroepen, wordt milliseconden geretourneerd sinds de sp_xml_preparedocument-aanroep. |
Opmerkingen
De levensduur van sql_handles gebruikt om de SQL-tekst op te halen die een aanroep heeft uitgevoerd om te sp_xml_preparedocument het plan in de cache dat is gebruikt om de query uit te voeren, wordt overleeft. Als de querytekst niet beschikbaar is in de cache, kunnen de gegevens niet worden opgehaald met behulp van de informatie in het functieresultaat. Dit kan gebeuren als u veel grote batches uitvoert.
Machtigingen
Vereist de machtiging VIEW SERVER STATE op de server om alle sessies of sessie-id's te zien die niet eigendom zijn van de beller. Een beller kan altijd de gegevens voor hun eigen huidige sessie-id zien.
Machtigingen voor SQL Server 2022 en hoger
Vereist de machtiging PRESTATIESTATUS VAN DE WEERGAVESERVER op de server.
Voorbeelden
In het volgende voorbeeld worden alle actieve ingangen geselecteerd.
SELECT * FROM sys.dm_exec_xml_handles(0);
Zie ook
dynamische beheerweergaven en -functies (Transact-SQL)
uitvoeringsgerelateerde dynamische beheerweergaven en -functies (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)