다음을 통해 공유


sp_cursoroption(Transact-SQL)

적용 대상: SQL Server

커서 옵션을 설정하거나 저장 프로시저에서 sp_cursoropen 만든 커서 정보를 반환합니다. sp_cursoroption 는 TDS(테이블 형식 데이터 스트림) 패킷을 지정하여 ID = 8 호출됩니다.

Transact-SQL 구문 표기 규칙

구문

sp_cursoroption cursor , code , value
[ ; ]

인수

cursor

handle SQL Server에서 생성되고 저장 프로시저에서 반환되는 sp_cursoropen 값입니다. 커서 매개 변수는 int이며 이 매개 변수가 될 NULL수 없습니다.

code

커서 반환 값의 다양한 요소를 규정하는 데 사용됩니다. 코드 매개 변수는 int이며 다음 값 중 하나여야 합니다.

이름 설명
0x0001 TEXTPTR_ONLY 지정된 특정 텍스트 또는 이미지 열에 대해 실제 데이터가 아닌 텍스트 포인터를 반환합니다.

TEXTPTR_ONLY를 사용하면 나중에 Transact-SQL 또는 DBLIB 기능(예: Transact-SQL READTEXT 또는 DBLIBDBWRITETEXT)을 사용하여 선택적으로 검색하거나 업데이트할 수 있는 Blob 개체에 대한 핸들텍스트 포인터를 사용할 수 있습니다.
값이 0 할당된 경우 선택 목록의 모든 텍스트 및 이미지 열은 데이터가 아닌 텍스트 포인터를 반환합니다.
0x0002 CURSOR_NAME 값으로 지정된 이름을 커서에 할당합니다. 이 이름을 사용하면 ODBC에서 열린 sp_cursoropen커서에서 Transact-SQL 위치 UPDATE/DELETE 문을 사용할 수 있습니다.

문자열은 모든 문자 또는 유니코드 데이터 형식으로 지정할 수 있습니다.
Transact-SQL 위치 문은 UPDATE/DELETE 기본적으로 fat 커서 sp_cursor SETPOSITION 의 첫 번째 행에서 작동하므로 위치 지정 문을 실행하기 전에 커서를 배치 UPDATE/DELETE 하는 데 사용해야 합니다.
0x0003 TEXTDATA 이후 페치에서 특정 텍스트 또는 이미지 열에 대한 텍스트 포인터가 아닌 실제 데이터를 반환합니다(즉, 효과 TEXTPTR_ONLY취소).

특정 열에 대해 사용하도록 설정된 경우 TEXTDATA 행이 다시 래치되거나 새로 고쳐지고 다시 TEXTPTR_ONLY설정할 수 있습니다. 값 TEXTPTR_ONLY매개 변수는 열 번호를 지정하는 정수이고 0 값은 모든 텍스트 또는 이미지 열을 반환합니다.
0x0004 SCROLLOPT 스크롤 옵션입니다. 자세한 내용은 코드 값 반환을 참조 하세요.
0x0005 CCOPT 동시성 제어 옵션입니다. 자세한 내용은 코드 값 반환을 참조 하세요.
0x0006 ROWCOUNT 결과 집합의 현재 행 수입니다.

참고: ROWCOUNT 비동기 채우기를 사용하는 경우 반환된 sp_cursoropen 값 이후 변경되었을 수 있습니다. 행 수를 알 수 없는 경우 값 -1 이 반환됩니다.

value

코드에서 반환되는 값을 지정합니다. 은 , 0x0002또는 0x0003 코드 입력 값을 호출0x0001하는 필수 매개 변수입니다.

코드2 은 문자열 데이터 형식입니다. 다른 코드 값 입력 또는 값으로 반환되는 모든 코드 값은 int입니다.

반환 코드 값

매개 변수는 다음 코드 값 중 하나를 반환할 수 있습니다.

반환 값 설명
0x0004 SCROLLOPT
0X0005 CCOPT
0X0006 ROWCOUNT

매개 변수는 다음 SCROLLOPT 값 중 하나를 반환합니다.

반환 값 설명
0x0001 KEYSET
0x0002 DYNAMIC
0x0004 FORWARD_ONLY
0x0008 STATIC

매개 변수는 다음 CCOPT 값 중 하나를 반환합니다.

반환 값 설명
0x0001 READ_ONLY
0x0002 SCROLL_LOCKS
0x0004 or 0x0008 OPTIMISTIC