Compartir a través de


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 vigencia 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)