sys.dm_exec_xml_handles(Transact-SQL)
적용 대상: 
SQL Server Azure SQL Managed Instance
sp_xml_preparedocument 연 활성 핸들에 대한 정보를 반환합니다.
구문
dm_exec_xml_handles (session_id | 0 )
인수
session_id | 0,
세션의 ID입니다. session_id 지정하면 이 함수는 지정된 세션의 XML 핸들에 대한 정보를 반환합니다.
0을 지정하면 함수는 모든 세션에 대한 모든 XML 핸들에 대한 정보를 반환합니다.
반환된 테이블
| 열 이름 | 데이터 형식 | 설명 |
|---|---|---|
| session_id | int | 이 XML 문서 핸들을 보유하는 세션의 세션 ID입니다. |
| document_id | int | sp_xml_preparedocument 반환된 XML 문서 핸들 ID입니다. |
| namespace_document_id | int | sp_xml_preparedocument 세 번째 매개 변수로 전달된 연결된 네임스페이스 문서에 사용되는 내부 핸들 ID입니다. 네임스페이스 문서가 없는 경우 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 | 날짜/시간 | 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_preparedocumen호출 이후 밀리초를 반환합니다. |
설명
sp_xml_preparedocument 호출을 실행한 SQL 텍스트를 검색하는 데 사용되는 sql_handles 수명은 쿼리를 실행하는 데 사용된 캐시된 계획보다 오래 실행됩니다. 캐시에서 쿼리 텍스트를 사용할 수 없는 경우 함수 결과에 제공된 정보를 사용하여 데이터를 검색할 수 없습니다. 많은 대규모 일괄 처리를 실행하는 경우 이 문제가 발생할 수 있습니다.
사용 권한
호출자가 소유하지 않은 모든 세션 또는 세션 ID를 보려면 서버에 대한 VIEW SERVER STATE 권한이 필요합니다. 호출자는 항상 자신의 현재 세션 ID에 대한 데이터를 볼 수 있습니다.
SQL Server 2022 이상에 대한 사용 권한
서버에 대한 VIEW SERVER PERFORMANCE STATE 권한이 필요합니다.
예제
다음 예제에서는 모든 활성 핸들을 선택합니다.
SELECT * FROM sys.dm_exec_xml_handles(0);
참고 항목
동적 관리 뷰 및 함수(Transact-SQL)
실행 관련 동적 관리 뷰 및 함수(Transact-SQL)
sp_xml_preparedocument(Transact-SQL)
sp_xml_removedocument(Transact-SQL)