Поделиться через


sys.dm_exec_xml_handles (Transact-SQL)

Возвращает сведения об активных дескрипторах, открытых процедурой sp_xml_preparedocument.

Синтаксис

dm_exec_xml_handles (session_id | 0 )

Аргументы

  • session_id | 0,
    Идентификатор сеанса. Если указан аргумент session_id, функция возвращает сведения о дескрипторах XML в указанном сеансе.

    Если указано значение 0, функция возвращает сведения обо всех дескрипторах XML во всех сеансах.

Возвращаемая таблица

Имя столбца

Тип данных

Описание

session_id

int

Идентификатор сеанса, содержащего данный XML-документ.

document_id

int

Идентификатор дескриптора XML-документа, возвращаемый процедурой sp_xml_preparedocument.

namespace_document_id

int

Внутренний идентификатор дескриптора, используемый для документа связанного пространства имен, переданного в третьем аргументе процедуры sp_xml_preparedocument. NULL, если документ пространства имен отсутствует.

sql_handle

varbinary(64)

Дескриптор текста кода SQL, в котором был определен дескриптор.

statement_start_offset

int

Место (в символах) в текущем выполняемом пакете или хранимой процедуре, с которого выполняется вызов процедуры sp_xml_preparedocument. Вместе со значениями столбцов sql_handle и statement_start_offset это значение может быть использовано для получения текущей выполняемой инструкции данного запроса при помощи функции динамического управления sys.dm_exec_sql_text.

statement_end_offset

int

Место (в символах) в текущем выполняемом пакете или хранимой процедуре, с которого выполняется вызов процедуры sp_xml_preparedocument. Вместе со значениями столбцов sql_handle и statement_start_offset это значение может быть использовано для получения текущей выполняемой инструкции данного запроса при помощи функции динамического управления sys.dm_exec_sql_text.

creation_time

datetime

Отметка времени момента создания процедуры sp_xml_preparedocument.

original_document_size_bytes

bigint

Размер непроанализированного XML-документа в байтах.

original_namespace_document_size_bytes

bigint

Размер непроанализированного документа пространства имен XML в байтах. NULL, если документ пространства имен отсутствует.

num_openxml_calls

bigint

Число вызовов инструкции OPENXML с данным дескриптором документа.

row_count

bigint

Число строк, возвращенных всеми предыдущими вызовами инструкции OPENXML для данного дескриптора документа.

dormant_duration_ms

bigint

Число миллисекунд, прошедших с момента последнего вызова инструкции OPENXML. Если инструкция OPENXML не вызывалась, возвращается число миллисекунд, истекших с момента вызова процедуры sp_xml_preparedocument

Замечания

Время жизни дескрипторов sql_handles, используемых для получения текста SQL, выполнившего запрос к процедуре sp_xml_preparedocument, превышает время жизни кэшированного плана, используемого для выполнения запроса. Если текст запроса в кэше недоступен, извлечь данные с помощью сведений, возвращаемых этой функцией, невозможно. Это может произойти при выполнении множества больших пакетов.

Разрешения

Требуется разрешение VIEW SERVER STATE на сервер, чтобы просмотреть все сеансы или идентификаторы сеансов, которыми не владеет участник. Участник всегда может просмотреть данные для своего текущего идентификатора сеанса.

Примеры

В следующем примере выбираются все активные дескрипторы.

select * from sys.dm_exec_xml_handles(0)

См. также

Справочник

Динамические административные представления и функции (Transact-SQL)

Динамические административные представления и функции, связанные с выполнением (Transact-SQL)