JetSetTableSequential 함수

아티클
07/03/2023

적용 대상: Windows | Windows Server

JetSetTableSequential 함수

JetSetTableSequential 함수는 애플리케이션이 지정된 커서가 포함된 전체 현재 인덱스를 검사하고 있음을 데이터베이스 엔진에 알 수 있습니다. 따라서 인덱스 데이터에 액세스하는 데 사용되는 메서드는 이 시나리오를 가능한 한 빨리 만들기 위해 조정됩니다.

Windows XP:JetSetTableSequential 은 Windows XP에 도입되었습니다.

    JET_ERR JET_API JetSetTableSequential(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_GRBIT grbit
    );

매개 변수

sesid

이 호출에 사용할 세션입니다.

tableid

이 호출에 사용할 커서입니다.

grbit

다음 옵션 중 0개 이상을 지정하는 비트 그룹입니다.

값	의미
JET_bitPrereadForward	이 옵션은 정방향으로 인덱싱하는 데 사용됩니다. Windows 7:JET_bitPrereadForward Windows 7에 도입되었습니다.
JET_bitPrereadBackward	이 옵션은 뒤로 방향으로 인덱싱하는 데 사용됩니다. Windows 7:JET_bitPrereadBackward Windows 7에 도입되었습니다.

값

의미

JET_bitPrereadForward

이 옵션은 정방향으로 인덱싱하는 데 사용됩니다.

Windows 7:JET_bitPrereadForward Windows 7에 도입되었습니다.

JET_bitPrereadBackward

이 옵션은 뒤로 방향으로 인덱싱하는 데 사용됩니다.

Windows 7:JET_bitPrereadBackward Windows 7에 도입되었습니다.

반환 값

이 함수는 다음 반환 코드 중 하나를 사용하여 JET_ERR 데이터 형식을 반환합니다. 가능한 ESE 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.

반환 코드	설명
JET_errClientRequestToStopJetService	세션과 연결된 instance 대한 모든 작업이 JetStopService 호출의 결과로 정지되었기 때문에 작업을 완료할 수 없습니다.
JET_errInstanceUnavailable	세션과 연결된 instance 해당 데이터의 무결성을 보호하기 위해 모든 데이터에 대한 액세스를 취소해야 하는 심각한 오류가 발생하여 작업을 완료할 수 없습니다. Windows XP: 이 반환 값은 Windows XP에 도입되었습니다.
JET_errNotInitialized	세션과 연결된 instance 아직 초기화되지 않았기 때문에 작업을 완료할 수 없습니다.
JET_errRestoreInProgress	세션과 연결된 instance 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다.
JET_errTermInProgress	세션과 연결된 instance 종료 중이므로 작업을 완료할 수 없습니다.

이 함수가 성공하면 커서의 현재 인덱스가 전체 인덱스의 순차적 검사에 최적화됩니다. 데이터베이스 상태는 변경되지 않습니다.

이 함수가 실패하면 커서 구성이 변경되지 않습니다. 데이터베이스 상태는 변경되지 않습니다.

설명

애플리케이션이 인덱스의 알려진 하위 집합을 효율적으로 검색해야 하는 경우 JetSetIndexRange를 사용하여 인덱스 범위가 설정될 때마다 유사한 최적화도 수행됩니다. 이 최적화는 Windows XP 이상 릴리스에서만 사용할 수 있습니다.

애플리케이션이 알 수 없는 인덱스 하위 집합을 효율적으로 검사해야 하는 경우 아무 작업도 수행하지 않아야 합니다. 엔진은 검사 동작을 자동으로 감지할 수 있으며 미리 데이터를 가져옵니다. 그러나 이 동작은 공격적이지 않습니다.

이 최적화를 통해 기본 인덱스 검사를 효율적으로 수행하고 보조 인덱스에서 인덱스 항목 데이터만 검사할 수 있습니다. 레코드 데이터를 검색하는 동안 보조 인덱스 검사를 효율적으로 수행하지 않습니다. 엔진이 레코드 데이터에 대해 미리 읽기를 수행하지 않기 때문입니다.

요구 사항

요구 사항	값
클라이언트	Windows Vista 또는 Windows XP가 필요합니다.
서버	Windows Server 2008 또는 Windows Server 2003이 필요합니다.
머리글	Esent.h에 선언되었습니다.
라이브러리	ESENT.lib를 사용합니다.
DLL	ESENT.dll 필요합니다.

참고 항목

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetSetIndexRange
JetStopService

JetSetTableSequential 함수