sys.dm_exec_xml_handles (Transact-SQL)
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 della 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 dell'handle interno utilizzato 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 nella stored procedure o nel batch attualmente in esecuzione in corrispondenza del quale viene chiamata la stored procedure sp_xml_preparedocument. Può essere utilizzata in combinazione con la colonna sql_handle, la colonna statement_end_offset e la funzione a gestione dinamica sys.dm_exec_sql_text per recuperare l'istruzione in esecuzione per la richiesta. |
statement_end_offset |
int |
Numero di caratteri nella stored procedure o nel batch attualmente in esecuzione in corrispondenza del quale viene chiamata la stored procedure sp_xml_preparedocument. Può essere utilizzata in combinazione con la colonna sql_handle, la colonna statement_start_offset e la funzione a gestione dinamica sys.dm_exec_sql_text per recuperare l'istruzione in esecuzione per la richiesta. |
creation_time |
datetime |
Timestamp della data e ora di esecuzione della chiamata a 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 non è stata eseguita alcuna chiamata a OPENXML, restituisce i millisecondi trascorsi dalla chiamata a sp_xml_preparedocument. |
Osservazioni
La durata del valore di sql_handles utilizzato per recuperare il testo SQL che ha eseguito una chiamata a sp_xml_preparedocument è superiore al piano memorizzato nella cache utilizzato per l'esecuzione della 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.
Esempi
Nell'esempio seguente vengono selezionati tutti gli handle attivi.
select * from sys.dm_exec_xml_handles(0)