sys.dm_exec_xml_handles (Transact-SQL)
Aplica-se a:
SQL ServerAzure SQL Managed Instance
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á informações sobre todos os identificadores XML para 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 esse identificador de documento XML. |
| document_id | int | ID do identificador de documento XML retornado 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 | varbinário(64) | Manipule o texto do código SQL onde o identificador foi definido. |
| statement_start_offset | int | Número de caracteres no lote ou procedimento armazenado em execução no qual a chamada sp_xml_preparedocument ocorre. Pode ser usado em conjunto com o sql_handle, o statement_end_offsete a função de gerenciamento dinâmico sys.dm_exec_sql_text para recuperar a instrução atualmente em execução para a solicitação. |
| statement_end_offset | int | Número de caracteres no lote ou procedimento armazenado em execução no qual a chamada sp_xml_preparedocument ocorre. Pode ser usado em conjunto com o sql_handle, o statement_start_offsete a função de gerenciamento dinâmico sys.dm_exec_sql_text para recuperar a instrução atualmente em execução 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 de namespace XML não analisado, em bytes. NULL se não houver nenhum documento de namespace. |
| num_openxml_calls | bigint | Número de chamadas OPENXML com este identificador de documento. |
| row_count | bigint | Número de linhas retornadas por todas as chamadas OPENXML anteriores para este identificador de documento. |
| dormant_duration_ms | bigint | Milissegundos desde a última chamada OPENXML. Se OPENXML não tiver sido chamado, retornará milissegundos desde a chamada sp_xml_preparedocument. |
Comentários
O tempo de vida do 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 da consulta não estiver disponível no cache, os dados não poderão ser recuperados usando as informações fornecidas no resultado da função. Isso pode 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ão que não são de propriedade do chamador. Um chamador sempre pode ver os dados de seu próprio ID de sessão atual.
Permissões para SQL Server 2022 e posterior
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);
Ver também
Visões e funções de gerenciamento dinâmico (Transact-SQL)
Visualizações e funções de gerenciamento dinâmico relacionadas à execução (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)