다음을 통해 공유

sp_cursor_list(Transact-SQL)

  • 아티클

현재 연결에 대해 열려 있는 서버 커서의 특성을 보고합니다.

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

sp_cursor_list [ @cursor_return = ] cursor_variable_name OUTPUT 
          , [ @cursor_scope = ] cursor_scope

인수

  • [ @cursor_return = ] cursor_variable_nameOUTPUT
    선언된 커서 변수의 이름입니다. cursor_variable_name은 cursor이며 기본값은 없습니다. 커서는 스크롤할 수 있으며 동적이고 읽기 전용입니다.

  • [ @cursor_scope = ] cursor_scope
    보고할 커서의 수준을 지정합니다. cursor_scope는 int이고 기본값은 없으며 다음 값 중 하나일 수 있습니다.

    값 설명

    1

    모든 로컬 커서를 보고합니다.

    2

    모든 전역 커서를 보고합니다.

    3

    로컬과 전역 커서 모두를 보고합니다.

반환 코드 값

없음

주의

sp_cursor_list는 연결에 의해 열린 현재 서버 커서의 목록을 작성하고 커서의 스크롤 가능 여부 및 업데이트 가능성 등과 같은 각 커서의 전역 특성을 설명합니다. sp_cursor_list에 의해 나열되는 커서는 다음과 같습니다.

  • Transact-SQL 서버 커서
  • ODBC 응용 프로그램에 의해 열린 다음 SQLSetCursorName 호출을 통해 명명된 API 서버 커서

커서가 반환한 결과 집합의 특성 설명을 보려면 sp_describe_cursor_columns를 사용합니다. 커서가 참조하는 기본 테이블에 대한 보고서를 보려면 sp_describe_cursor_tables을 사용합니다. sp_describe_cursor는 sp_cursor_list와 동일한 정보를 보고하지만 지정된 커서에 대해서만 보고한다는 점이 다릅니다.

사용 권한

실행 권한은 기본적으로 public 역할로 설정됩니다.

반환되는 커서

sp_cursor_list는 결과 집합이 아니라 Transact-SQL 커서 출력 매개 변수를 반환합니다. 따라서 Transact-SQL 일괄 처리, 저장 프로시저 및 트리거가 한 번에 하나의 출력 행을 처리할 수 있습니다. 이는 데이터베이스 API 함수에서 직접 프로시저를 호출할 수 없음을 의미하기도 합니다. 커서 출력 매개 변수는 반드시 프로그램 변수에 바인딩되어야 하지만 데이터베이스 API는 커서 매개 변수 또는 변수의 바인딩을 지원하지 않기 때문입니다.

다음은 sp_cursor_list에 의해 반환되는 커서의 형식입니다. 이 형식은 sp_describe_cursor에 의해 반환되는 커서 형식과 동일합니다.

열 이름 데이터 형식 설명

reference_name

sysname

커서를 참조할 때 사용하는 이름입니다. DECLARE CURSOR 문에서 지정된 이름으로 커서를 참조하는 경우 참조 이름과 커서 이름이 동일합니다. 커서에 대한 참조가 변수를 통해 이루어지는 경우 참조 이름은 커서 변수의 이름이 됩니다.

cursor_name

sysname

DECLARE CURSOR 문의 커서 이름입니다. SQL Server 2005에서 커서 변수를 커서로 설정하여 커서를 만든 경우 cursor_name은 커서 변수의 이름을 반환합니다. 이전 릴리스의 경우 이 출력 열은 시스템에서 생성한 이름을 반환합니다.

cursor_scope

smallint

1 = 로컬

2 = 전역

status

smallint

CURSOR_STATUS 시스템 함수에 의해 보고된 것과 동일한 값입니다.

1 = 커서 이름 또는 변수가 참조하는 커서가 열려 있습니다. 커서가 변경 내용을 감지하지 않거나 정적이거나 키 집합인 경우 적어도 한 개 이상의 행이 있습니다. 커서가 동적인 경우 결과 집합에는 0개 이상의 행이 있습니다.

0 = 커서 이름 또는 변수가 참조하는 커서가 열려 있으나 행이 없습니다. 동적 커서는 절대 값을 반환하지 않습니다.

-1 = 커서 이름 또는 변수가 참조하는 커서가 닫혀 있습니다.

-2 = 커서 변수에만 적용됩니다. 변수에 할당된 커서가 없습니다. OUTPUT 매개 변수가 커서를 변수에 할당했으나 저장 프로시저가 반환 전에 커서를 닫았을 수 있습니다.

-3 = 지정된 이름의 커서 또는 커서 변수가 없거나 커서 변수에 할당된 커서가 없습니다.

model

smallint

1 = 변경 내용 미감지(또는 정적)

2 = 키 집합

3 = 동적

4 = 빠른 전진

concurrency

smallint

1 = 읽기 전용

2 = 스크롤 잠금

3 = 낙관적

scrollable

smallint

0 = 전진 전용

1 = 스크롤 가능

open_status

smallint

0 = 닫힘

1 = 열림

cursor_rows

int

결과 집합의 행 수입니다. 자세한 내용은 @@CURSOR_ROWS를 참조하십시오.

fetch_status

smallint

해당 커서의 마지막 인출 상태입니다. 자세한 내용은 @@FETCH_STATUS를 참조하십시오.

0 = 인출 성공입니다.

-1 = 인출이 실패하였거나 커서의 범위 밖입니다.

-2 = 요청한 행이 누락되었습니다.

-9 = 커서에 대한 인출이 없습니다.

column_count

smallint

커서 결과 집합 내의 열 수입니다.

row_count

smallint

커서의 마지막 조작에 의해 영향을 받는 행의 수입니다. 자세한 내용은 @@ROWCOUNT를 참조하십시오.

last_operation

smallint

커서에서 수행된 마지막 조작입니다.

0 = 커서에서 조작이 수행되지 않았습니다.

1 = 열기

2 = 인출

3 = 삽입

4 = 업데이트

5 = 삭제

6 = 닫기

7 = 할당 취소

cursor_handle

int

서버 범위에서 커서를 식별하는 고유한 값입니다.

예

다음 예에서는 전역 커서를 열고 sp_cursor_list를 사용하여 커서의 특성에 대해 보고합니다.

USE AdventureWorks
GO
-- Declare and open a keyset-driven cursor.
DECLARE abc CURSOR KEYSET FOR
SELECT LastName
FROM Person.Contact
WHERE LastName LIKE 'S%'
OPEN abc

-- Declare a cursor variable to hold the cursor output variable
-- from sp_cursor_list.
DECLARE @Report CURSOR

-- Execute sp_cursor_list into the cursor variable.
EXEC master.dbo.sp_cursor_list @cursor_return = @Report OUTPUT,
      @cursor_scope = 2

-- Fetch all the rows from the sp_cursor_list output cursor.
FETCH NEXT from @Report
WHILE (@@FETCH_STATUS <> -1)
BEGIN
   FETCH NEXT from @Report
END

-- Close and deallocate the cursor from sp_cursor_list.
CLOSE @Report
DEALLOCATE @Report
GO

-- Close and deallocate the original cursor.
CLOSE abc
DEALLOCATE abc
GO

참고 항목

참조

시스템 저장 프로시저(Transact-SQL)

도움말 및 정보

SQL Server 2005 지원 받기