sp_cursorfetch(Transact-SQL)

데이터베이스에서 하나 이상의 행 버퍼를 인출합니다. 이 버퍼의 행 그룹을 커서의 인출 버퍼라고 합니다. sp_cursorfetch는 TDS(Tabular Data Stream) 패킷에서 ID = 7을 지정하여 호출합니다.

Transact-SQL 구문 표기 규칙

구문

sp_cursorfetch cursor 
    [ , fetchtype [ , rownum [ , nrows ] ] ] 

인수

• cursor
  SQL Server에서 생성되고 sp_cursoropen에서 반환되는 핸들 값입니다. cursor은 int 입력 값을 필요로 하는 필수 매개 변수입니다. 자세한 내용은 이 항목의 뒷부분에 나오는 주의 섹션을 참조하십시오.

• fetchtype
  인출할 커서 버퍼를 지정합니다. fetchtype은 다음 정수 입력 값 중 하나를 필요로 하는 선택적 매개 변수입니다.

  값	이름	설명
  0x0001	FIRST	첫 nrows개 행 버퍼를 인출합니다. nrows가 0이면 커서는 결과 집합 앞에 배치되며 행이 반환되지 않습니다.
  0x0002	NEXT	다음 nrows개 행 버퍼를 인출합니다.
  0x0004	PREV	이전 nrows개 행 버퍼를 인출합니다. [!참고]    FORWARD_ONLY는 한 방향 스크롤만 지원하므로 FORWARD_ONLY 커서에 대해 PREV를 사용하면 오류 메시지가 반환됩니다.
  0x0008	LAST	마지막 nrows개 행 버퍼를 인출합니다. If nrows 가 0이면 커서는 결과 집합 뒤에 배치되며 행이 반환되지 않습니다. [!참고]    FORWARD_ONLY는 한 방향 스크롤만 지원하므로 FORWARD_ONLY 커서에 대해 LAST를 사용하면 오류 메시지가 반환됩니다.
  0x10	ABSOLUTE	rownum 행부터 시작하여 nrows개 행의 버퍼를 인출합니다. [!참고]    FORWARD_ONLY는 한 방향 스크롤만 지원하므로 DYNAMIC 커서 또는 FORWARD_ONLY 커서에 대해 ABSOLUTE를 사용하면 오류 메시지가 반환됩니다.
  0x20	RELATIVE	현재 블록의 첫 행에서 rownum 값 행으로 지정된 행부터 시작하여 nrows개 행 버퍼를 인출합니다. 이 경우 rownum은 음수일 수 있습니다. [!참고]    FORWARD_ONLY는 한 방향 스크롤만 지원하므로 FORWARD_ONLY 커서에 대해 RELATIVE를 사용하면 오류 메시지가 반환됩니다.
  0x80	REFRESH	기본 테이블의 버퍼를 다시 채웁니다.
  0x100	INFO	커서에 대한 정보를 검색합니다. 이 정보는 rownum 및 nrows 매개 변수를 사용하여 반환합니다. 따라서 INFO를 지정하면 rownum 및 nrows는 출력 매개 변수가 됩니다.
  0x200	PREV_NOADJUST	PREV와 같이 사용되지만 결과 집합 맨 위가 중간에 나오면 결과가 달라질 수 있습니다.
  0x400	SKIP_UPDT_CNCY	다른 fetchtype 값 중 하나(INFO 제외)와 함께 사용해야 합니다.

  [!참고]

     0x40 값은 지원되지 않습니다.

  자세한 내용은 이 항목의 뒷부분에 나오는 주의 섹션을 참조하십시오.

• rownum
  입력 또는 출력 중 하나나 둘 다에 대해 정수 값만 사용하여 ABSOLUTE 및 INFO fetchtype 값의 행 위치를 지정하는 데 사용되는 선택적 매개 변수입니다. rownum은 fetchtype 비트 값 RELATIVE의 행 오프셋 역할을 합니다. 다른 모든 값에 대해서는 rownum이 무시됩니다. 자세한 내용은 이 항목의 뒷부분에 나오는 주의 섹션을 참조하십시오.

• nrows
  인출할 행 수를 지정하는 데 사용되는 선택적 매개 변수입니다. nrows를 지정하지 않는 경우의 기본값은 20개 행입니다. 데이터를 반환하지 않고 위치를 설정하려면 값을 0으로 지정합니다. nrows를 fetchtype INFO 쿼리에 적용하면 해당 쿼리의 총 행 수가 반환됩니다.

  [!참고]

     nrows는 REFRESH fetchtype 비트 값에 의해 무시됩니다.

  자세한 내용은 이 항목의 뒷부분에 나오는 주의 섹션을 참조하십시오.

반환 코드 값

비트 값 INFO를 지정할 때 반환될 수 있는 값이 다음 표에 나와 있습니다.

[!참고]

:   행이 반환되지 않는 경우 버퍼 콘텐츠는 그대로 유지됩니다.

주의

cursor 매개 변수

인출 작업이 수행되기 전까지 커서의 기본 위치는 결과 집합의 첫 번째 행 앞입니다.

fetchtype 매개 변수

SKIP_UPD_CNCY를 제외하면 fetchtype 값은 함께 사용할 수 없습니다.

SKIP_UPDT_CNCY를 지정하면 행을 인출하거나 새로 고칠 때 타임스탬프 열 값이 키 집합 테이블에 기록되지 않습니다. 키 집합 행을 업데이트하는 경우 타임스탬프 열의 값은 이전 값으로 유지됩니다. 키 집합 행을 삽입하는 경우에는 타임스탬프 열의 값이 정의되지 않습니다.

KEYSET 커서의 경우 이는 키 집합 테이블의 값이 건너뛰지 않는 마지막 FETCH(수행하는 경우) 중에 설정됨을 의미하며, 그 외의 경우에는 값이 채우기 중에 설정됩니다.

DYNAMIC 커서의 경우 이는 새로 고침과 함께 건너뛰기를 수행하는 경우 KEYSET과 같은 결과가 생성됨을 의미합니다. 다른 모든 인출 유형의 경우에는 키 집합 테이블이 잘립니다. 즉, 행이 삽입되는 중이며 타임스탬프 열의 값은 정의되지 않습니다. 따라서 DYNAMIC 커서에 대해 sp_cursorfetch를 실행할 때는 REFRESH 외의 작업에 대해 SKIP_UPDT_CNCY를 사용하지 않아야 합니다.

요청한 커서 위치가 결과 집합을 벗어나서 인출 작업이 실패하는 경우에는 커서 위치가 마지막 행 바로 다음으로 설정됩니다. 요청한 커서 위치가 결과 집합 앞에 배치되어 있어서 인출 작업이 실패하는 경우에는 커서 위치가 첫 번째 행 바로 앞으로 설정됩니다.

rownum 매개 변수

rownum을 사용하면 지정한 행부터 버퍼가 채워집니다.

fetchtype 값 ABSOLUTE는 전체 결과 집합 내의 rownum 위치를 참조합니다. ABSOLUTE의 값이 음수이면 작업에서 결과 집합의 끝에서부터 행을 카운트하도록 지정됩니다.

fetchtype 값 RELATIVE는 현재 버퍼 시작 부분의 커서 위치와 관련하여 rownum의 위치를 참조합니다. RELATIVE의 값이 음수이면 커서가 현재 커서 위치에서 뒤로 이동하도록 지정됩니다.

nrows 매개 변수

fetchtype 값 REFRESH 및 INFO는 이 매개 변수를 무시합니다.

nrow 값이 0인 fetchtype 값 FIRST를 지정하면 인출 버퍼에 행이 없는 결과 집합 앞에 커서가 배치됩니다.

nrow 값이 0인 fetchtype 값 LAST를 지정하면 현재 인출 버퍼에 행이 없는 결과 집합 뒤에 커서가 배치됩니다.

fetchtype 값 NEXT, PREV, ABSOLUTE, RELATIVE 및 PREV_NOADJUST의 경우에는 nrow 값을 0으로 지정할 수 없습니다.

RPC 고려 사항

RPC 반환 상태는 키 집합 크기 매개 변수가 최종인지 여부, 즉 비동기 방식으로 채워지고 있는 항목이 키 집합인지 임시 테이블인지를 나타냅니다.

RPC 상태 매개 변수는 다음 표에 나와 있는 값 중 하나로 설정됩니다.

행이 일반적인 결과 집합, 즉 열 형식(0x2a), 행(0xd1), 완료(0xfd) 순으로 반환됩니다. 메타데이터 토큰은 sp_cursoropen,에 대해 지정된 것과 같은 형식으로 전송됩니다. 예를 들면 SQL Server 7.0 사용자의 경우 0x81, 0xa5, 0xa4 등입니다. 행 상태 표시기는 BROWSE 모드와 비슷하게 각 행 끝에 숨겨진 열로 전송됩니다. 열 이름은 rowstat이고 데이터 형식은 INT4입니다. 이 rowstat 열은 다음 표에 있는 값 중 하나를 포함할 수 있습니다.

TDS 프로토콜은 이전 열을 보내지 않고 후행 상태 열을 보내는 방법을 제공하지 않으므로, 누락된 열에 대해서는 더미 데이터가 전송됩니다. 이 경우 Null 허용 필드는 Null로 설정되고 고정 길이 필드는 0, 빈 값, 해당 열의 기본값 중 적절한 값으로 설정됩니다.

DONE 행 개수는 항상 0이 됩니다. DONE 메시지는 실제 결과 집합 행 개수를 포함하며, 오류 또는 정보 메시지가 TDS 메시지 사이에 나타날 수 있습니다.

커서의 선택 목록에 대한 메타데이터가 TDS 스트림에 반환되도록 요청하려면 RPC RETURN_METADATA 입력 플래그를 1로 설정합니다.

예

1.PREV를 사용하여 커서 위치 변경

h2 커서가 다음과 같은 내용의 결과 집합을 생성하며 현재 위치는 아래와 같다고 가정해 봅니다.

row 1 contents    
row 2 contents
row 3 contents
row 4 contents  <-- current position
row 5 contents 
row 6 contents

다음으로 nrows 값이 5인 sp_cursorfetch PREV가 결과 집합의 첫 번째 행에서 두 행 앞에 커서를 논리적으로 배치합니다. 이 경우 커서가 첫 행에서 시작하도록 조정되며 요청한 행 수가 반환됩니다. 따라서 PRIOR 인출 버퍼에 있던 행이 반환되는 경우가 많습니다.

[!참고]

 RPC 상태 매개 변수가 2로 설정된 경우 위와 같은 현상이 발생합니다.

2.PREV_NOADJUST를 사용하여 PREV보다 적은 행 수 반환

PREV_NOADJUST는 반환하는 행 블록에서 현재 커서 위치나 그 뒤에 있는 행을 포함하지 않습니다. PREV가 현재 위치 뒤의 행을 반환하는 경우 PREV_NOADJUST는 nrows에서 요청하는 것보다 적은 수의 행을 반환합니다. 위의 1번 예에 나와 있는 현재 위치를 사용하는 경우 PREV를 적용하면 sp_cursorfetch(h2, 4, 1, 5)는 다음 행을 인출합니다.

row1 contents 
row2 contents
row3 contents
row4 contents
row5 contents

그러나 PREV_NOADJUST를 적용하면 sp_cursorfetch(h2, 512, 6, 5)는 다음 행만 인출합니다.

row1 contents 
row2 contents
row3 contents 

참고 항목

참조

sp_cursoropen(Transact-SQL)

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