sys.dm_exec_xml_handles (Transact-SQL)
Se aplica a: SQL Server Azure SQL Managed Instance
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)