sys.dm_exec_xml_handles (Transact-SQL)

Devuelve información acerca de 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 acerca de los identificadores XML en 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 columna	Tipo de datos	Descripción
session_id	int	Id. de la sesión que contiene este identificador del documento XML.
document_id	int	Id. del identificador del documento XML devuelto por sp_xml_preparedocument.
namespace_document_id	int	Id. del 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 del procedimiento almacenado o el lote que se está ejecutando actualmente y en el que se produce la llamada a sp_xml_preparedocument. Se puede utilizar junto con la función de administración dinámica sql_handle, statement_end_offset y sys.dm_exec_sql_text para recuperar la instrucción de ejecución actual para la solicitud.
statement_end_offset	int	Número de caracteres del procedimiento almacenado o el lote que se está ejecutando actualmente y en el que se produce la llamada a sp_xml_preparedocument. Se puede utilizar junto con la función de administración dinámica sql_handle, statement_start_offset y sys.dm_exec_sql_text para recuperar la instrucción de ejecución actual para la solicitud.
creation_time	datetime	Marca de tiempo que indica cuándo 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 hecho ninguna llamada OPENXML, devuelve los milisegundos desde la llamada sp_xml_preparedocument.

Comentarios

La duración de los sql_handles usados para recuperar el texto de SQL que ha ejecutado una llamada sp_xml_preparedocument sobrevive al plan almacenado en caché utilizado 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.

Ejemplos

En el siguiente ejemplo se seleccionan todos los identificadores activos.

select * from sys.dm_exec_xml_handles(0)

Vea también

Referencia

Funciones y vistas de administración dinámica (Transact-SQL)

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