sys.dm_exec_xml_handles (Transact-SQL)

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

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, essa 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 usada 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 em execução no momento ou no procedimento armazenado no qual a chamada sp_xml_preparedocument ocorre. Pode ser usado junto com o sql_handle, o statement_end_offset e a função de gerenciamento dinâmico sys.dm_exec_sql_text para recuperar a instrução em execução atualmente para a solicitação.
statement_end_offset	int	Número de caracteres no lote em execução no momento ou no procedimento armazenado no qual a chamada sp_xml_preparedocument ocorre. Pode ser usado junto com o sql_handle, o statement_start_offset e a função de gerenciamento dinâmico sys.dm_exec_sql_text para recuperar a instrução em execução atualmente para a 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 tiver sido chamado, retornará milissegundos desde que o sp_xml_preparedocumenchamada t.

Comentários

O tempo de vida de sql_handles usado para recuperar o texto SQL que executou uma chamada para sp_xml_preparedocument sobrevive ao plano armazenado em 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.

Permissões para SQL Server 2022 e posteriores

Requer a permissão VIEW SERVER PERFORMANCE STATE no servidor.

Exemplos

O exemplo a seguir seleciona todos os identificadores ativos.

SELECT * FROM sys.dm_exec_xml_handles(0);  

Consulte Também

Exibições e funções de gerenciamento dinâmico (Transact-SQL)
Funções e exibições de gerenciamento dinâmico relacionadas à execução (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)