sp_cursorexecute(Transact-SQL)

  • 아티클

적용 대상:SQL Server

sp_cursorprepare 만든 실행 계획에 따라 커서를 만들고 채웁니다. 이 프로시저는 sp_cursorprepare 함께 sp_cursoropen 함수와 동일하지만 두 단계로 나뉩니다. sp_cursorexecute TDS(테이블 형식 데이터 스트림) 패킷에서 ID =4를 지정하여 호출됩니다.

Transact-SQL 구문 표기 규칙

구문

  
sp_cursorexecute prepared_handle, cursor  
    [ , scrollopt[ OUTPUT ]  
    [ , ccopt[ OUTPUT ]  
    [ ,rowcount OUTPUT [ ,bound param][,...n]]]]]

인수

prepared_handle
sp_cursorprepare 반환된 준비된 문 핸들 값입니다. prepared_handle int 입력 값을 호출하는 필수 매개 변수입니다.

cursor
SQL Server에서 생성된 커서 식별자입니다. 커서는 커서에 따라 작동하는 모든 후속 프로시저에서 제공해야 하는 필수 매개 변수입니다(예: sp_cursorfetch

scrollopt
스크롤 옵션입니다. scrollopt는 int 입력 값이 필요한 선택적 매개 변수입니다. sp_cursorexecutescrollopt 매개 변수에는 sp_cursoropen 값 옵션과 동일한 값 옵션이 있습니다.

참고 항목

PARAMETERIZED_STMT 값은 지원되지 않습니다.

Important

scrollopt 값을 지정하지 않으면 기본값은 sp_cursorprepare 지정된 scrollopt 값에 관계없이 KEYSET입니다.

ccopt
통화 제어 옵션입니다. ccopt는 int 입력 값이 필요한 선택적 매개 변수입니다. sp_cursorexecuteccopt 매개 변수에는 sp_cursoropen 값 옵션과 동일한 값 옵션이 있습니다.

Important

ccopt 값을 지정하지 않으면 기본값은 sp_cursorprepare 지정된 ccopt 값에 관계없이 OPTIMISTIC입니다.

Rowcount
AUTO_FETCH에 사용할 인출 버퍼 행 수를 나타내는 선택적 매개 변수입니다. 기본값은 20개 행입니다. rowcount 는 입력 값과 반환 값으로 할당되는 경우 다르게 동작합니다.

입력 값으로 반환 값으로
AUTO_FETCH FAST_FORWARD 커서 행 개수 로 지정된 경우 페치 버퍼에 배치할 행 수를 나타냅니다. 결과 집합의 행 수를 나타냅니다. scrollopt AUTO_FETCH 값을 지정하면 행 개수는 페치 버퍼로 페치된 행 수를 반환합니다.

bound_param
추가 매개 변수의 선택적 사용을 의미합니다.

참고 항목

다섯 번째 매개 변수 이후의 모든 매개 변수는 문 계획에 입력 매개 변수로 전달됩니다.

코드 반환 값

rowcount 는 다음 값을 반환할 수 있습니다.

값 설명
-1 행 수를 알 수 없습니다.
-n 비동기 채우기가 적용됩니다.

설명

scrollopt 및 ccopt 매개 변수

scrollopt 및 ccopt 는 서버 캐시에 대해 캐시된 계획을 선점할 때 유용합니다. 즉, 문을 식별하는 준비된 핸들을 다시 컴파일해야 합니다. scrollopt 및 ccopt 매개 변수 값은 sp_cursorprepare 위해 원래 요청에서 보낸 값과 일치해야 합니다.

참고 항목

scrollopt에 PARAMETERIZED_STMT 할당하면 안 됩니다.

일치하는 값을 제공하지 않으면 계획이 다시 컴파일되어 준비 및 실행 작업을 부정하게 됩니다.

RPC 및 TDS 고려 사항

커서 선택 목록 메타데이터가 TDS 스트림에 반환되도록 요청하기 위해 RPC RETURN_METADATA 입력 플래그를 1로 설정할 수 있습니다.

참고 항목

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