다음을 통해 공유


행 스크롤 및 가져오기 - ODBC에서 행 책갈피 지정

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

책갈피는 데이터 행을 식별하는 데 사용되는 값입니다. 책갈피 값의 의미는 드라이버 또는 데이터 원본에만 알려져 있습니다. 예를 들어 행 번호만큼 간단하거나 디스크 주소만큼 복잡할 수 있습니다. ODBC 애플리케이션에서는 특정 행에 대해 책갈피를 요청하고 이를 저장한 다음 다시 커서에 전달하여 원래 행으로 돌아갑니다.

SQLFetchScroll사용하여 행을 가져올 때 애플리케이션은 시작 행을 선택하기 위한 기준으로 책갈피를 사용할 수 있습니다. 현재 커서 위치에 의존하지 않기 때문에 절대 주소 지정의 한 형태입니다. 책갈피가 지정된 행으로 스크롤하기 위해 애플리케이션은 SQL_FETCH_BOOKMARK FetchOrientation을 사용하여 SQLFetchScroll을 호출합니다. 이 작업은 SQL_ATTR_FETCH_BOOKMARK_PTR 옵션 특성이 가리키는 책갈피를 사용하며 해당 책갈피로 식별된 행부터 시작하는 행 집합을 반환합니다. 애플리케이션은 SQLFetchScroll 호출의 FetchOffset 인수에서 이 작업에 대한 오프셋을 지정할 수 있습니다. 오프셋을 지정하면 반환된 행 집합의 첫 번째 행은 FetchOffset 인수의 숫자를 책갈피로 식별된 행 수에 추가하여 결정됩니다. SQL Server Native Client ODBC 드라이버는 정적 및 키 집합 커서에 대한 책갈피만 지원합니다. 책갈피를 설정할 때 동적 커서가 요청되면 대신 키 집합 커서가 열립니다.

책갈피는 SQLBulkOperations 함수와 함께 사용하여 책갈피에서 시작하는 행 집합에 대한 작업을 수행할 수도 있습니다.

참고 항목

행 스크롤 및 가져오기