Compartir vía


sys.dm_exec_xml_handles (Transact-SQL)

Se aplica a: SQL Server Azure SQL Instancia administrada

Devuelve información sobre los identificadores activos abiertos por sp_xml_preparedocument.

Sintaxis

  
dm_exec_xml_handles (session_id | 0 )  

Argumentos

session_id | 0,
Id. de la sesión. Si se especifica session_id , esta función devuelve información sobre los identificadores XML de la sesión especificada.

Si se especifica 0, esta función devuelve información acerca de todos los identificadores XML de todas las sesiones.

Tabla devuelta

Nombre de la columna Tipo de datos Descripción
session_id int Id. de la sesión que contiene este identificador del documento XML.
document_id int Identificador de identificador de documento XML devuelto por sp_xml_preparedocument.
namespace_document_id int Identificador de identificador interno usado para el documento de espacio de nombres asociado que se ha pasado como tercer parámetro a sp_xml_preparedocument. Es NULL si no hay ningún documento de espacio de nombres.
sql_handle varbinary(64) Identificador del texto del código SQL en el que se ha definido el identificador.
statement_start_offset int Número de caracteres en el lote que se está ejecutando actualmente o en el procedimiento almacenado en el que se produce la llamada sp_xml_preparedocument . Se puede usar junto con el sql_handle, el statement_end_offset y la función de administración dinámica sys.dm_exec_sql_text para recuperar la instrucción que se está ejecutando actualmente para la solicitud.
statement_end_offset int Número de caracteres en el lote que se está ejecutando actualmente o en el procedimiento almacenado en el que se produce la llamada sp_xml_preparedocument . Se puede usar junto con el sql_handle, el statement_start_offset y la función de administración dinámica sys.dm_exec_sql_text para recuperar la instrucción que se está ejecutando actualmente para la solicitud.
creation_time datetime Marca de tiempo cuando se llamó a sp_xml_preparedocument .
original_document_size_bytes bigint Tamaño del documento XML no analizado, en bytes.
original_namespace_document_size_bytes bigint Tamaño del documento de espacio de nombres XML no analizado, en bytes. Es NULL si no hay ningún documento de espacio de nombres.
num_openxml_calls bigint Número de llamadas OPENXML para este identificador de documento.
row_count bigint Número de filas devueltas por todas las llamadas OPENXML anteriores para este identificador de documento.
dormant_duration_ms bigint Milisegundos desde la última llamada OPENXML. Si no se ha llamado a OPENXML, devuelve milisegundos desde la llamada sp_xml_preparedocument.

Comentarios

La duración de sql_handles usada para recuperar el texto SQL que ejecutó una llamada a sp_xml_preparedocument sobrevivirá al plan almacenado en caché usado para ejecutar la consulta. Si el texto de la consulta no está disponible en la memoria caché, los datos no pueden recuperarse usando la información proporcionada en el resultado de la función. Esto puede ocurrir si está ejecutando muchos lotes grandes.

Permisos

Requiere el permiso VIEW SERVER STATE en el servidor para ver todas las sesiones o Id. de sesión que no son propiedad del autor de la llamada. El autor de la llamada siempre puede ver los datos de su propio Id. de sesión actual.

Permisos para SQL Server 2022 y versiones posteriores

Requiere el permiso VER ESTADO DE RENDIMIENTO DEL SERVIDOR en el servidor.

Ejemplos

En el siguiente ejemplo se seleccionan todos los identificadores activos.

SELECT * FROM sys.dm_exec_xml_handles(0);  

Consulte también


Funciones y vistas de administración dinámica (Transact-SQL)
Funciones y vistas de administración dinámica relacionadas con ejecuciones (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)