sys.dm_exec_xml_handles (Transact-SQL)
Si applica a:
SQL ServerIstanza gestita di SQL di Azure
Restituisce informazioni sugli handle attivi aperti da sp_xml_preparedocument.
Sintassi
dm_exec_xml_handles (session_id | 0 )
Argomenti
session_id | 0,
ID della sessione. Se si specifica session_id , questa funzione restituisce informazioni sugli handle XML nella sessione specificata.
Se si specifica 0, la funzione restituisce informazioni su tutti gli handle XML di tutte le sessioni.
Tabella restituita
| Nome colonna | Tipo di dati | Descrizione |
|---|---|---|
| session_id | int | ID della sessione che contiene l'handle del documento XML. |
| document_id | int | ID dell'handle di documento XML restituito da sp_xml_preparedocument. |
| namespace_document_id | int | ID handle interno usato per il documento dello spazio dei nomi associato passato come terzo parametro a sp_xml_preparedocument. È NULL se non esiste un documento dello spazio dei nomi. |
| sql_handle | varbinary(64) | Handle per il testo del codice SQL in cui l'handle è stato definito. |
| statement_start_offset | int | Numero di caratteri nel batch o nella stored procedure attualmente in esecuzione in cui viene eseguita la chiamata sp_xml_preparedocument . Può essere usato insieme al sql_handle, al statement_end_offset e alla funzione di gestione dinamica sys.dm_exec_sql_text per recuperare l'istruzione attualmente in esecuzione per la richiesta. |
| statement_end_offset | int | Numero di caratteri nel batch o nella stored procedure attualmente in esecuzione in cui viene eseguita la chiamata sp_xml_preparedocument . Può essere usato insieme al sql_handle, al statement_start_offset e alla funzione di gestione dinamica sys.dm_exec_sql_text per recuperare l'istruzione attualmente in esecuzione per la richiesta. |
| creation_time | datetime | Timestamp quando è stato chiamato sp_xml_preparedocument . |
| original_document_size_bytes | bigint | Dimensioni in byte del documento XML non analizzato. |
| original_namespace_document_size_bytes | bigint | Dimensioni in byte del documento dello spazio dei nomi XML non analizzato. È NULL se non esiste un documento dello spazio dei nomi. |
| num_openxml_calls | bigint | Numero di chiamate a OPENXML con questo handle di documento. |
| row_count | bigint | Numero di righe restituite da tutte le chiamate a OPENXML precedenti per questo handle di documento. |
| dormant_duration_ms | bigint | Millisecondi trascorsi dall'ultima chiamata a OPENXML. Se OPENXML non è stato chiamato, restituisce millisecondi dalla chiamata sp_xml_preparedocument. |
Osservazioni:
Durata di sql_handles utilizzata per recuperare il testo SQL che ha eseguito una chiamata a sp_xml_preparedocument dura il piano memorizzato nella cache usato per eseguire la query. Se il testo della query non è disponibile nella cache, non sarà possibile recuperare i dati utilizzando le informazioni incluse nel risultato della funzione. Questa situazione può verificarsi in caso di esecuzione di numerosi batch di grandi dimensioni.
Autorizzazioni
È richiesta l'autorizzazione VIEW SERVER STATE sul server per visualizzare tutte le sessioni o gli ID di sessione che non appartengono al chiamante. Un chiamante può sempre visualizzare i dati per il proprio ID sessione corrente.
Autorizzazioni per SQL Server 2022 e versioni successive
È richiesta l'autorizzazione VIEW SERVER PERFORMANCE STATE per il server.
Esempi
Nell'esempio seguente vengono selezionati tutti gli handle attivi.
SELECT * FROM sys.dm_exec_xml_handles(0);
Vedi anche
Funzioni a gestione dinamica e DMV (Transact-SQL)
Funzioni e viste a gestione dinamica relative all'esecuzione (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)