sys.dm_exec_xml_handles (Transact-SQL)

Si applica a: SQL Server Istanza 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 del proprio ID della 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)