Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Применимо к:
SQL ServerУправляемый экземпляр SQL Azure
Возвращает сведения о активных дескрипторах, открытых sp_xml_preparedocument.
Syntax
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_end_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 истекает кэшированный план, используемый для выполнения запроса. Если текст запроса в кэше недоступен, извлечь данные с помощью сведений, возвращаемых этой функцией, невозможно. Это может произойти при выполнении множества больших пакетов.
Permissions
Требуется VIEW разрешение SERVER STATE на сервере, чтобы видеть все сессии или идентификаторы сессий, которые не принадлежат вызывающему. Вызывающий объект всегда может просматривать данные для собственного идентификатора текущего сеанса.
Разрешения для SQL Server 2022 и более поздних версий
Требуется VIEW разрешение на состояние производительности сервера на сервере.
Examples
В следующем примере выбираются все активные дескрипторы.
SELECT * FROM sys.dm_exec_xml_handles(0);
См. также
Динамические административные представления и функции (Transact-SQL)
Связанные с выполнением динамические административные представления и функции (Transact-SQL)
sp_xml_preparedocument (Transact-SQL)
sp_xml_removedocument (Transact-SQL)