sys.dm_exec_xml_handles (Transact-SQL)

  • Articolo

Si applica a:Istanza gestita di SQL Di Azure di SQL Server

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 del proprio ID della sessione corrente.

Autorizzazioni per SQL Server 2022 e versioni successive

È richiesta l'autorizzazione VIEW SERVER PERFORMANCE STATE nel server.

Esempi

Nell'esempio seguente vengono selezionati tutti gli handle attivi.

SELECT * FROM sys.dm_exec_xml_handles(0);

Vedi anche


Funzioni e viste a gestione dinamica (Transact-SQL)
Funzioni e viste a gestione dinamica correlate all'esecuzione (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)