sys.dm_exec_xml_handles (Transact-SQL)
Retorna informações sobre identificadores ativos que foram abertos por sp_xml_preparedocument.
Sintaxe
dm_exec_xml_handles (session_id | 0 )
Argumentos
session_id | 0,
ID da sessão. Se session_id for especificado, esta função retornará informações sobre identificadores XML na sessão especificada.Se 0 for especificado, a função retornará as informações sobre todos os identificadores XML em todas as sessões.
Tabela retornada
Nome da coluna |
Tipo de dados |
Descrição |
|---|---|---|
session_id |
int |
ID de sessão da sessão que contém o identificador de documento XML. |
document_id |
int |
ID do identificador de documento XML retornada por sp_xml_preparedocument. |
namespace_document_id |
int |
ID do identificador interno usado para o documento de namespace associado que foi passado como o terceiro parâmetro para sp_xml_preparedocument. NULL se não houver nenhum documento de namespace. |
sql_handle |
varbinary(64) |
Identificador para o texto do código SQL em que o identificador foi definido. |
statement_start_offset |
int |
Número de caracteres no lote executado atualmente ou procedimento armazenado no qual a chamada de sp_xml_preparedocument ocorre. Pode ser usado junto com a função de gerenciamento dinâmico sql_handle, statement_end_offset e sys.dm_exec_sql_text para recuperar a instrução atualmente em execução da solicitação. |
statement_end_offset |
int |
Número de caracteres no lote executado atualmente ou procedimento armazenado no qual a chamada de sp_xml_preparedocument ocorre. Pode ser usado junto com a função de gerenciamento dinâmico sql_handle, statement_start_offset e sys.dm_exec_sql_text para recuperar a instrução atualmente em execução da solicitação. |
creation_time |
datetime |
Carimbo de data/hora quando sp_xml_preparedocument foi chamado. |
original_document_size_bytes |
bigint |
Tamanho do documento XML não analisado em bytes. |
original_namespace_document_size_bytes |
bigint |
Tamanho do documento XML de namespace não analisado, em bytes. NULL se não houver nenhum documento de namespace. |
num_openxml_calls |
bigint |
Número de chamadas de OPENXML com esse identificador de documento. |
row_count |
bigint |
Número de linhas retornadas por todas as chamadas de OPENXML anteriores para esse identificador de documento. |
dormant_duration_ms |
bigint |
Milissegundos desde a última chamada de OPENXML. Se OPENXML não foi chamado, retornará milissegundos desde a última chamada de sp_xml_preparedocument. |
Comentários
O tempo de vida de sql_handles usado para recuperar o texto SQL que executou uma chamada a sp_xml_preparedocument é maior que o plano de cache usado para executar a consulta. Se o texto de consulta não estiver disponível no cache, os dados não poderão ser recuperados usando as informações fornecidas no resultado de função. Isso poderá ocorrer se você estiver executando muitos lotes grandes.
Permissões
Requer a permissão VIEW SERVER STATE no servidor para ver todas as sessões ou IDs de sessões que não pertencem ao chamador. Um chamador sempre pode ver os dados para sua própria ID de sessão atual.
Exemplos
O exemplo a seguir seleciona todos os identificadores ativos.
select * from sys.dm_exec_xml_handles(0)