적용 대상:
SQL ServerAzure SQL DatabaseAzure SQL Managed Instance
중요합니다
이 기능은 이후 버전의 Windows에서 제거됩니다. 새 개발 작업에서 이 기능을 사용하지 말고 현재 이 기능을 사용하는 애플리케이션을 수정할 계획입니다. 드라이버의 커서 기능을 사용하는 것이 좋습니다.
ODBC 커서 라이브러리는 정방향 전용 커서만 지원하는 ODBC 2.x 드라이버에 대해 스크롤 가능한 커서 지원을 제공합니다. 연결에 커서 라이브러리를 사용하도록 설정하면 드라이버 관리자가 함수 호출을 가로채서 드라이버에 직접 연결하지 않고 커서 라이브러리를 통해 라우팅합니다. 커서 라이브러리는 함수 자체를 실행하거나 기본 드라이버에 전달합니다.
커서 라이브러리에서 실행되는 함수
이 문서에서는 커서 라이브러리가 처리하는 ODBC 함수와 드라이버에 전달되는 ODBC에 대해 설명합니다.
| 조항 | Description |
|---|---|
| 커서 라이브러리에서 실행되는 ODBC 함수 | 커서 라이브러리가 스크롤 가능한 커서 기능을 제공하기 위해 자체 구현하는 함수를 나열합니다. |
| 커서 라이브러리에서 실행되지 않는 ODBC 함수 | 커서 라이브러리가 수정 없이 드라이버에 전달하는 함수를 나열합니다. |
열 및 매개 변수 바인딩
이러한 함수는 결과 집합 열 및 문 매개 변수에 바인딩 애플리케이션 버퍼를 처리합니다. 커서 라이브러리는 위치가 지정된 업데이트를 지원하고 커서를 차단하도록 동작을 수정합니다.
| 기능 | Description |
|---|---|
| SQLBindCol(커서 라이브러리) | 결과 집합 열에 애플리케이션 버퍼를 바인딩합니다. 커서 라이브러리는 위치가 지정된 업데이트 및 삭제 작업을 지원하기 위해 바인딩을 추적합니다. |
| SQLBindParameter(커서 라이브러리) | 애플리케이션 버퍼를 매개 변수 표식에 바인딩합니다. 커서 라이브러리는 이 호출을 드라이버에 전달합니다. |
대량 및 위치 지정 작업
이러한 함수는 행 집합에 대해 대량 작업을 수행하고 커서의 현재 행 집합 내의 개별 행에 배치된 업데이트를 수행합니다.
| 기능 | Description |
|---|---|
| SQLBulkOperations(커서 라이브러리) | 책갈피 작업으로 대량 삽입, 업데이트, 삭제 또는 가져오기를 수행합니다. 커서 라이브러리는 ODBC 2.x 드라이버로 작업할 SQLSetPos 때 이를 매핑합니다. |
| SQLSetPos(커서 라이브러리) | 행 집합 내에 커서를 배치하고 애플리케이션이 행 집합의 데이터를 새로 고치거나 업데이트하거나 삭제할 수 있도록 합니다. |
커서 관리 및 트랜잭션
이러한 함수는 커서 수명 및 트랜잭션 경계를 관리합니다.
| 기능 | Description |
|---|---|
| SQLCloseCursor(커서 라이브러리) | 문의 커서를 닫고 보류 중인 결과를 삭제합니다. |
| SQLEndTran(커서 라이브러리) | 트랜잭션을 커밋하거나 롤백합니다. 커서 라이브러리는 및 설정에 SQL_CURSOR_COMMIT_BEHAVIORSQL_CURSOR_ROLLBACK_BEHAVIOR 따라 트랜잭션 경계를 넘어 커서 상태를 관리합니다. |
| SQLFreeStmt(커서 라이브러리) | 문 처리를 중지하고, 연결된 커서를 닫고, 보류 중인 결과를 삭제하고, 문 핸들과 연결된 모든 리소스를 선택적으로 해제합니다. |
데이터 검색
이러한 함수는 결과 집합에서 데이터를 가져옵니다. 커서 라이브러리는 전방 전용 커서만 지원하는 드라이버에 스크롤 가능한 커서 기능을 제공합니다.
| 기능 | Description |
|---|---|
| SQLFetch(커서 라이브러리) | 결과 집합에서 데이터의 다음 행 집합을 가져옵니다. ODBC 2.x 드라이버로 작업할 때 커서 라이브러리는 이를 에 SQLExtendedFetch매핑합니다. |
| SQLFetchScroll(커서 라이브러리) | 결과 집합에서 지정된 데이터 행 집합을 가져오고 모든 바인딩된 열에 대한 데이터를 반환합니다. 첫 번째, 마지막, 다음, 이전, 절대 및 상대 위치를 포함하여 다양한 스크롤 방향을 지원합니다. |
| SQLExtendedFetch(커서 라이브러리) | 결과 집합에서 지정된 행 집합을 가져옵니다. 이 함수는 ODBC 3.x에서 더 이상 사용되지 않습니다. 대신 사용합니다 SQLFetchScroll . |
| SQLGetData(커서 라이브러리) | 결과 집합에서 단일 열에 대한 데이터를 검색하거나 SQLFetchScroll 호출한 후 SQLFetch 검색합니다. |
설명자 작업
이러한 함수는 설명자 필드 값을 가져와서 설정합니다. 설명자는 매개 변수 및 결과 집합 열의 특성을 정의합니다.
| 기능 | Description |
|---|---|
| SQLGetDescField 및 SQLGetDescRec(커서 라이브러리) | 개별 필드 값 또는 전체 설명자 레코드를 검색합니다. 커서 라이브러리는 내부 설명자에 대해 이를 처리합니다. |
| SQLSetDescField 및 SQLSetDescRec(커서 라이브러리) | 개별 필드 값 또는 전체 설명자 레코드를 설정합니다. 커서 라이브러리는 설명자 필드의 변경 내용을 추적합니다. |
드라이버 기능 쿼리
이러한 함수는 드라이버 및 커서 라이브러리 기능에 대한 정보를 반환합니다.
| 기능 | Description |
|---|---|
| SQLGetFunctions(커서 라이브러리) | 드라이버에서 지원하는 ODBC 함수에 대한 정보를 반환합니다. 커서 라이브러리는 구현하는 함수를 포함하도록 응답을 수정합니다. |
| SQLGetInfo(커서 라이브러리) | 드라이버 및 데이터 원본에 대한 일반 정보를 반환합니다. 커서 라이브러리는 해당 기능을 반영하도록 특정 커서 관련 정보 유형을 수정합니다. |
문 및 연결 특성
이러한 함수는 커서 동작에 영향을 주는 문, 연결 및 환경 특성을 가져와서 설정합니다.
| 기능 | Description |
|---|---|
| SQLGetStmtAttr(커서 라이브러리) | 문 특성의 현재 값을 반환합니다. 커서 라이브러리는 커서 동작과 관련된 특성을 처리합니다. |
| SQLGetStmtOption(커서 라이브러리) | 문 옵션 값을 반환합니다. 이 함수는 ODBC 3.x에서 더 이상 사용되지 않습니다. 대신 사용합니다 SQLGetStmtAttr . |
| SQLSetStmtAttr(커서 라이브러리) | 문 특성을 설정합니다. 커서 라이브러리는 커서 관련 특성을 처리하여 스크롤 가능한 커서 지원을 구현합니다. |
| SQLSetScrollOptions(커서 라이브러리) | 커서 동작을 제어하는 옵션을 설정합니다. 이 함수는 ODBC 3.x에서 더 이상 사용되지 않습니다. 대신 커서 관련 특성과 함께 사용합니다 SQLSetStmtAttr . |
| SQLSetConnectAttr(커서 라이브러리) | 연결 특성을 설정합니다. 커서 라이브러리는 특성을 처리 SQL_ATTR_ODBC_CURSORS 하여 커서 라이브러리 사용을 사용하거나 사용하지 않도록 설정합니다. |
| SQLSetEnvAttr(커서 라이브러리) | 환경 특성을 설정합니다. 커서 라이브러리는 이 호출을 드라이버 관리자에 전달합니다. |
SQL 변환 및 행 작업
이러한 함수는 SQL 문 변환 및 행 개수 검색을 처리합니다.
| 기능 | Description |
|---|---|
| SQLNativeSql(커서 라이브러리) | 드라이버에서 수정한 대로 SQL 문자열을 반환합니다. 커서 라이브러리는 이 호출을 수정하지 않고 드라이버에 전달합니다. |
| SQLRowCount(커서 라이브러리) | UPDATE, INSERT 또는 DELETE 문의 영향을 받는 행 수를 반환합니다. 커서 라이브러리는 위치가 지정된 업데이트 및 삭제 작업에 대한 행 수를 추적합니다. |