sys.dm_exec_xml_handles(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure 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 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_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)