ODBC 3.x 애플리케이션의 블록 커서, 스크롤 가능 커서 및 이전 버전과의 호환성

SQLFetchScroll과 SQLExtendedFetch는 애플리케이션이 호출하는 함수 집합인 API(애플리케이션 프로그래밍 인터페이스)와 드라이버가 구현하는 함수 집합인 SPI(서비스 공급자 인터페이스) 간의 ODBC에서 첫 번째 명확한 분할을 나타냅니다. 이 분할은 SQLFetchScroll을 사용하는 ODBC 3.x의 요구 사항의 균형을 맞추고 표준에 부합하고 SQLExtendedFetch를 사용하는 ODBC 2.x와 호환되는 데 필요합니다.

애플리케이션이 호출하는 함수 집합인 ODBC 3.x API에는 SQLFetchScroll 및 관련 문 특성이 포함됩니다. 드라이버가 구현하는 함수 집합인 ODBC 3.x SPI에는 SQLFetchScroll, SQLExtendedFetch 및 관련 문 특성이 포함됩니다. ODBC는 API와 SPI 간에 이 분할을 공식적으로 적용하지 않으므로 ODBC 3.x 애플리케이션에서 SQLExtendedFetch 및 관련 문 특성을 호출할 수 있습니다. 그러나 ODBC 3.x 애플리케이션에서 이 작업을 수행할 이유가 없습니다. API 및 SPIs에 대한 자세한 내용은 ODBC 아키텍처 소개를 참조하세요.

ODBC 3.x 드라이버 관리자가 ODBC 2.x 및 ODBC 3.x 드라이버에 호출을 매핑하는 방법과 블록 및 스크롤 가능한 커서에 대해 ODBC 3.x 드라이버가 구현해야 하는 함수 및 문 특성에 대한 자세한 내용은 부록 G: 이전 버전과의 호환성을 위한 드라이버 지침을 참조하세요.

다음 표에는 ODBC 3.x 애플리케이션이 블록 및 스크롤 가능한 커서에 사용해야 하는 함수 및 문 특성이 요약되어 있습니다. 또한 ODBC 3.x 애플리케이션이 ODBC 2.x 드라이버와 호환되도록 알고 있어야 하는 이 영역의 ODBC 2.x와 ODBC 3.x 간의 변경 내용도 나열합니다.

함수 또는 statement 특성	설명
SQL_ATTR_FETCH_BOOKMARK_PTR	SQLFetchScroll에 사용할 책갈피를 가리킵니다. 애플리케이션이 ODBC 2.x 드라이버에서 이를 설정하는 경우 고정 길이 책갈피를 가리킵니다.
SQL_ATTR_ROW_STATUS_PTR	SQLFetch, SQLFetchScroll, SQLBulkOperations 및 SQLSetPos로 채워진 행 상태 배열을 가리킵니다. 애플리케이션이 ODBC 2.x 드라이버에서 이를 설정하고 SQLFetchScroll, SQLFetch 또는 SQLExtendedFetch를 호출하기 전에 SQL_ADD 작업으로 SQLBulkOperation을 호출하면 SQLSTATE HY011(지금은 특성을 설정할 수 없음)이 반환됩니다. 애플리케이션이 ODBC 2.x 드라이버에서 SQLFetch를 호출하는 경우 SQLFetch는 SQLExtendedFetch에 매핑되므로 이 배열의 값을 반환합니다.
SQL_ATTR_ROWS_FETCHED_PTR	SQLFetch 및 SQLFetchScroll이 가져온 행 수를 반환하는 버퍼를 가리킵니다. 애플리케이션이 ODBC 2.x 드라이버에서 SQLFetch를 호출하는 경우 SQLFetch는 SQLExtendedFetch에 매핑되므로 이 버퍼의 값을 반환합니다.
SQL_ATTR_ROW_ARRAY_SIZE	행 집합 크기를 설정합니다. 애플리케이션이 ODBC 2.x 드라이버에서 SQL_ADD 연산을 사용하여 SQLBulkOperations를 호출하는 경우 호출이 SQL_ROWSET_SIZE 사용하는 SQL_ADD 작업으로 SQLSetPos에 매핑되기 때문에 SQL_ROWSET_SIZE SQL_ATTR_ROW_ARRAY_SIZE 아닌 호출에 사용됩니다. ODBC 2.x 드라이버에서 SQL_ADD 또는 SQLExtendedFetch 작업으로 SQLSetPos를 호출하는 경우 SQL_ROWSET_SIZE 사용합니다. ODBC 2.x 드라이버에서 SQLFetch 또는 SQLFetchScroll을 호출하는 경우 SQL_ATTR_ROW_ARRAY_SIZE 사용합니다.
SQLBulkOperations	삽입 및 책갈피 작업을 수행합니다. SQL_ADD 연산이 있는 SQLBulkOperations가 ODBC 2.x 드라이버에서 호출되면 SQL_ADD 연산을 사용하여 SQLSetPos에 매핑됩니다. 구현 세부 정보는 다음과 같습니다. - ODBC 2.x 드라이버로 작업할 때 애플리케이션은 StatementHandle과 연결된 암시적으로 할당된 ARD만 사용해야 합니다. 명시적 설명자 작업은 ODBC 2.x 드라이버에서 지원되지 않으므로 행을 추가하기 위해 다른 ARD를 할당할 수 없습니다. 애플리케이션은 SQLBindCol을 사용하여 SQLSetDescField 또는 SQLSetDescRec가 아닌 ARD에 바인딩해야 합니다. - ODBC 3.x 드라이버를 호출할 때 애플리케이션은 SQLFetch 또는 SQLFetchScroll을 호출하기 전에 SQL_ADD 작업으로 SQLBulkOperations를 호출할 수 있습니다. ODBC 2.x 드라이버를 호출할 때 애플리케이션은 SQL_ADD 작업으로 SQLBulkOperations를 호출하기 전에 SQLFetchScroll을 호출해야 합니다.
SQLFetch	다음 행 집합을 반환합니다. 구현 세부 정보는 다음과 같습니다. - 애플리케이션이 ODBC 2.x 드라이버에서 SQLFetch를 호출하면 SQLExtendedFetch에 매핑됩니다. - 애플리케이션이 ODBC 3.x 드라이버에서 SQLFetch를 호출하면 SQL_ATTR_ROW_ARRAY_SIZE 문 특성으로 지정된 행 수를 반환합니다.
SQLFetchScroll	지정된 행 집합을 반환합니다. 구현 세부 정보는 다음과 같습니다. - 애플리케이션이 ODBC 2.x 드라이버에서 SQLFetchScroll을 호출하는 경우 단일 행에 적용되는 각 오류 앞에 SQLSTATE 01S01(행 오류)을 반환합니다. ODBC 3.x 드라이버 관리자가 이를 SQLExtendedFetch에 매핑하고 SQLExtendedFetch가 이 SQLSTATE를 반환하기 때문에 이 작업을 수행합니다. 애플리케이션이 ODBC 3.x 드라이버에서 SQLFetchScroll을 호출하는 경우 SQLSTATE 01S01(행의 오류)을 반환하지 않습니다. - 애플리케이션이 FetchOrientation이 SQL_FETCH_BOOKMARK 설정된 ODBC 2.x 드라이버에서 SQLFetchScroll을 호출하는 경우 FetchOffset 인수를 0으로 설정해야 합니다. ODBC 2.x 드라이버로 오프셋 기반 책갈피 가져오기를 시도하면 SQLSTATE HYC00(선택적 기능이 구현되지 않음)이 반환됩니다.

참고 항목

ODBC 3.x 애플리케이션은 SQLExtendedFetch 또는 SQL_ROWSET_SIZE 문 특성을 사용하면 안 됩니다. 대신 SQLFetchScroll 및 SQL_ATTR_ROW_ARRAY_SIZE 문 특성을 사용해야 합니다. ODBC 3.x 애플리케이션은 SQL_ADD 작업에서 SQLSetPos를 사용하지 않아야 하지만 SQL_ADD 작업과 함께 SQLBulkOperations를 사용해야 합니다.