다음을 통해 공유


sys.dm_exec_cursors(Transact-SQL)

적용 대상: SQL Server

다양한 데이터베이스에 열려 있는 커서에 대한 정보를 반환합니다.

구문

  
dm_exec_cursors (session_id | 0 )  

인수

session_id | 0
세션의 ID입니다. session_id 지정한 경우 이 함수는 지정된 세션의 커서에 대한 정보를 반환합니다.

0을 지정하면 모든 세션의 모든 커서에 대한 정보가 반환됩니다.

반환된 테이블

열 이름 데이터 형식 설명
session_id int 이 커서를 보유하는 세션의 ID입니다.
cursor_id int 커서 개체의 ID입니다.
이름 nvarchar(256) 사용자가 정의한 커서의 이름입니다.
속성 nvarchar(256) 커서의 속성을 지정합니다. 다음 속성의 값은 이 열의 값을 구성하도록 연결됩니다.
선언 인터페이스
커서 유형
커서 동시성
커서 범위
커서 중첩 수준

예를 들어 이 열에 반환된 값은 "TSQL | 동적 | 낙관적 | 전역(0)".
sql_handle varbinary(64) 커서를 선언한 일괄 처리의 텍스트에 대한 핸들입니다.
statement_start_offset int 현재 실행 중인 일괄 처리 또는 저장 프로시저에서 현재 실행 중인 문이 시작되는 위치까지의 문자 수입니다. sql_handle, statement_end_offset 및 sys.dm_exec_sql_text 동적 관리 함수와 함께 사용하여 요청에 대해 현재 실행 중인 문을 검색할 수 있습니다.
statement_end_offset int 현재 실행 중인 일괄 처리 또는 현재 실행 중인 문이 종료되는 저장 프로시저의 문자 수입니다. sql_handle, statement_start_offset 및 sys.dm_exec_sql_text 동적 관리 함수와 함께 사용하여 요청에 대해 현재 실행 중인 문을 검색할 수 있습니다.
plan_generation_num bigint 다시 컴파일한 후 계획의 인스턴스를 구분하는 데 사용할 수 있는 시퀀스 번호입니다.
creation_time 날짜/시간 이 커서가 생성되었을 때의 타임스탬프입니다.
is_open bit 커서가 열려 있는지 여부를 지정합니다.
is_async_population bit 백그라운드 스레드가 여전히 KEYSET 또는 STATIC 커서를 비동기적으로 채우는지 여부를 지정합니다.
is_close_on_commit bit 커서가 CURSOR_CLOSE_ON_COMMIT을 사용하여 선언되었는지 여부를 지정합니다.

1 = 트랜잭션이 종료될 때 커서가 닫힙니다.
fetch_status int 커서의 마지막 인출 상태를 반환합니다. 마지막으로 반환된 @@FETCH_STATUS 값입니다.
fetch_buffer_size int 인출 버퍼의 크기에 대한 정보를 반환합니다.

1 = Transact-SQL 커서입니다. API 커서의 경우 더 높은 값으로 설정할 수 있습니다.
fetch_buffer_start int FAST_FORWARD 및 동적 커서의 경우 커서가 열려 있지 않거나 첫 번째 행 앞에 놓이면 0을 반환합니다. 그렇지 않으면 -1을 반환합니다.

STATIC 및 KEYSET 커서의 경우, 커서가 열려 있지 않으면 0을 반환하고 커서가 마지막 행 뒤에 있으면 -1을 반환합니다.

그렇지 않으면 위치가 지정된 행 번호를 반환합니다.
ansi_position int 페치 버퍼 내의 커서 위치입니다.
worker_time bigint 이 커서를 실행하는 작업자가 소요한 시간(마이크로초)입니다.
읽습니다 bigint 커서가 수행한 읽기 수입니다.
씁니다 bigint 커서에서 수행하는 쓰기 수입니다.
dormant_duration bigint 이 커서의 마지막 쿼리(열기 또는 인출)가 시작된 후 밀리초입니다.

사용 권한

서버에 대한 VIEW SERVER STATE 권한이 필요합니다.

SQL Server 2022 이상에 대한 권한

서버에 대한 VIEW SERVER PERFORMANCE STATE 권한이 필요합니다.

설명

다음 표에서는 커서 선언 인터페이스에 대한 정보를 제공하고 속성 열에 사용할 수 있는 값을 포함합니다.

속성 설명
API 커서는 데이터 액세스 API(ODBC, OLEDB) 중 하나를 사용하여 선언되었습니다.
TSQL Transact-SQL DECLARE CURSOR 구문을 사용하여 커서가 선언되었습니다.

다음 표에서는 커서 형식에 대한 정보를 제공하고 속성 열에 사용할 수 있는 값을 포함합니다.

Type 설명
키 집합 커서가 키 집합으로 선언되었습니다.
동적 커서가 동적으로 선언되었습니다.
스냅샷 커서가 스냅샷 또는 정적으로 선언되었습니다.
Fast_Forward 커서가 빠른 전달 선언되었습니다.

다음 표에서는 커서 동시성에 대한 정보를 제공하고 속성 열에 사용할 수 있는 값을 포함합니다.

동시성 설명
읽기 전용 커서가 읽기 전용으로 선언되었습니다.
Scroll Locks 커서는 스크롤 잠금을 사용합니다.
낙관적인 커서는 낙관적 동시성 제어를 사용합니다.

다음 표에서는 커서 범위에 대한 정보를 제공하고 속성 열에 사용할 수 있는 값을 포함합니다.

범위 설명
로컬 커서 범위를 커서가 생성된 일괄 처리, 저장 프로시저, 트리거에 대해 로컬로 지정합니다.
전역 커서 범위를 연결에 대해 전역으로 지정합니다.

예제

A. 이전 커서 검색

다음 예에서는 지정한 36시간을 초과하여 서버에서 열려 있는 커서에 대한 정보를 반환합니다.

SELECT creation_time, cursor_id, name, c.session_id, login_name   
FROM sys.dm_exec_cursors(0) AS c   
JOIN sys.dm_exec_sessions AS s ON c.session_id = s.session_id   
WHERE DATEDIFF(hh, c.creation_time, GETDATE()) > 36;  
GO  

참고 항목

동적 관리 뷰 및 함수(Transact-SQL)
실행 관련 동적 관리 뷰 및 함수(Transact-SQL)
sys.dm_exec_sessions(Transact-SQL)