Condividi tramite


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)