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)