sp_cursoroption(Transact-SQL)

  • 아티클

적용 대상:SQL Server

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

Transact-SQL 구문 표기 규칙

구문

  
sp_cursoroption cursor, code, value

인수

cursor
SQL Server에서 생성되고 sp_cursoropen 저장 프로시저에서 반환되는 핸들 값입니다. 커서를실행하려면 int 입력 값이 필요합니다.

code
커서 반환 값의 다양한 요소를 규정하는 데 사용됩니다. 코드 에는 다음 int 입력 값 중 하나가 필요합니다.

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

TEXTPTR_ONLY 나중에 Transact-SQL 또는 DBLIB 기능(예: Transact-SQL READTEXT 또는 DBLIB DBWRITETEXT)을 사용하여 선택적으로 검색하거나 업데이트할 수 있는 Blob 개체에 대한 핸들로 텍스트 포인터를 사용할 수 있습니다.

"0" 값이 할당된 경우 선택 목록의 모든 텍스트 및 이미지 열은 데이터가 아닌 텍스트 포인터를 반환합니다.
0x0002 CURSOR_NAME 값에 지정된 이름을 커서에 할당합니다. 따라서 ODBC는 sp_cursoropen 통해 열린 커서에서 Transact-SQL 위치 UPDATE/DELETE 문을 사용할 수 있습니다.

문자열은 모든 문자 또는 유니코드 데이터 형식으로 지정할 수 있습니다.

Transact-SQL 위치 UPDATE/DELETE 문은 기본적으로 fat 커서의 첫 번째 행에서 작동하므로 위치가 지정된 UPDATE/DELETE 문을 실행하기 전에 sp_cursor SETPOSITION을 사용하여 커서를 배치해야 합니다.
0x0003 TEXTDATA 후속 인출에서 특정 텍스트 또는 이미지 열에 대해 텍스트 포인터가 아닌 실제 데이터를 반환합니다. 즉, TEXTPTR_ONLY의 효과를 실행 취소합니다.

특정 열에 TEXTDATA를 사용하도록 설정하면 행을 다시 가져오거나 새로 고친 다음 다시 TEXTPTR_ONLY 설정할 수 있습니다. TEXTPTR_ONLY 마찬가지로 값 매개 변수는 열 번호를 지정하는 정수이고 0 값은 모든 텍스트 또는 이미지 열을 반환합니다.
0x0004 SCROLLOPT 스크롤 옵션입니다. 자세한 내용은 이 항목의 뒷부분에 있는 "반환된 코드 값"을 참조하세요.
0x0005 CCOPT 동시성 제어 옵션입니다. 자세한 내용은 이 항목의 뒷부분에 있는 "반환된 코드 값"을 참조하세요.
0x0006 ROWCOUNT 결과 집합의 현재 행 수입니다.

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

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

참고 항목

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

반환 코드 값

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

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

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

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

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

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

참고 항목

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