JetOpenTempTable3 함수

  • 아티클

적용 대상: Windows | Windows Server

JetOpenTempTable3 함수

JetOpenTempTable3 함수는 JetCreateTableColumnIndex를 사용하여 만든 일반 테이블처럼 레코드를 저장하고 검색하는 데 사용할 수 있는 단일 인덱스가 있는 임시 테이블을 만듭니다. 그러나 임시 테이블은 휘발성 특성으로 인해 일반 테이블보다 훨씬 빠릅니다. 순수하게 순차적으로 액세스할 때 레코드 집합에서 중복 제거를 매우 빠르게 정렬하고 수행하는 데 사용할 수도 있습니다.

    JET_ERR JET_API JetOpenTempTable3(
      __in          JET_SESID sesid,
      __in          const JET_COLUMNDEF* prgcolumndef,
      __in          unsigned long ccolumn,
      __in_opt      JET_UNICODEINDEX* pidxunicode,
      __in          JET_GRBIT grbit,
      __out         JET_TABLEID* ptableid,
      __out         JET_COLUMNID* prgcolumnid
    );

매개 변수

sesid

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

prgcolumndef

임시 테이블에서 만들 열의 열 정의를 식별합니다.

임시 테이블과 함께 사용할 수 있는 열 정의 옵션에는 중요한 제한 사항이 있습니다. 자세한 내용은 설명 부분을 참조하세요.

일반적인 열 정의 옵션 외에도 임시 테이블의 컨텍스트에서만 관련된 다음 옵션 중 0개 이상을 지정할 수도 있습니다.

값

의미

JET_bitColumnTTDescending

이 옵션은 임시 테이블에 대한 키 열의 정렬 순서가 오름차순이 아닌 내림차순이어야 했음을 나타냅니다. 이 옵션을 JET_bitColumnTTKey 없이 지정하면 이 옵션은 무시됩니다.

JET_bitColumnTTKey

이 옵션은 열이 임시 테이블의 키 열이 됨을 나타냅니다.

입력 배열에 지정된 이 옵션을 사용하는 열 정의의 순서에 따라 임시 테이블에 대한 각 키 열의 우선 순위가 결정됩니다. 이 옵션 집합이 있는 배열의 첫 번째 열 정의는 가장 중요한 키 열이 됩니다. 데이터베이스 엔진에서 지원될 수 있는 것보다 더 많은 키 열이 요청되면 지원되지 않는 키 열에 대해 이 옵션이 무시됩니다.

ccolumn

prgcolumndef를 참조하세요.

pidxunicode

임시 테이블의 유니코드 키 열 데이터를 비교하는 데 사용할 로캘 ID 및 정규화 플래그입니다.

이 매개 변수가 없으면 기본 LCID를 사용하여 임시 테이블의 유니코드 키 열을 비교합니다. 기본 LCID는 미국 영어 로캘입니다.

이 매개 변수가 없으면 기본 정규화 플래그를 사용하여 임시 테이블의 유니코드 키 열 데이터를 비교합니다. 기본 정규화 플래그는 NORM_IGNORECASE, NORM_IGNOREKANATYPE 및 NORM_IGNOREWIDTH.

grbit

다음 중 0개 이상을 포함하는 이 호출에 사용할 옵션이 포함된 비트 그룹입니다.

값

의미

JET_bitTTErrorOnDuplicateInsertion

이 옵션은 이전에 삽입한 레코드와 동일한 인덱스 키를 사용하여 레코드를 삽입하려고 하면 JET_errKeyDuplicate 즉시 실패하도록 요청합니다. 이 옵션을 요청하지 않으면 중복이 즉시 검색되어 실패하거나 요청된 기능에 따라 임시 테이블을 구현하기 위해 데이터베이스 엔진에서 선택한 전략에 따라 나중에 자동으로 제거될 수 있습니다.

이 기능이 필요하지 않은 경우 요청하지 않는 것이 가장 좋습니다. 이 기능이 요청되지 않은 경우 임시 테이블 관리자는 성능이 향상되는 임시 테이블을 관리하기 위한 전략을 선택할 수 있습니다.

JET_bitTTForceMaterialization

이 옵션은 임시 테이블 관리자가 성능 향상을 초래하는 임시 테이블을 관리하기 위한 영리한 전략을 선택하려는 시도를 중단하도록 강제합니다.

JET_bitTTForwardOnly

이 옵션은 임시 테이블 관리자가 중간 쿼리 결과에 최적화된 구현을 사용할 수 있는 경우에만 임시 테이블을 만들 것을 요청합니다. 임시 테이블의 특성으로 인해 이 최적화를 사용할 수 없는 경우 JET_errCannotMaterializeForwardOnlySort 작업이 실패합니다.

이 옵션의 부작용은 임시 테이블에 중복 인덱스 키가 있는 레코드를 포함할 수 있도록 하는 것입니다. 자세한 내용은 JET_bitTTUnique 참조하세요.

이 옵션은 Windows Server 2003 이상 릴리스에서만 사용할 수 있습니다.

JET_bitTTIndexed

이 옵션은 임시 테이블이 JetSeek 을 사용하여 인덱스 키로 레코드를 조회할 수 있을 만큼 유연하도록 요청합니다.

이 기능이 필요하지 않은 경우 요청하지 않는 것이 가장 좋습니다. 이 기능이 요청되지 않은 경우 임시 테이블 관리자는 성능이 향상되는 임시 테이블을 관리하기 위한 전략을 선택할 수 있습니다.

JET_bitTTUnique

이 옵션은 중복 인덱스 키가 있는 레코드를 임시 테이블의 마지막 레코드 집합에서 제거하도록 요청합니다.

Windows Server 2003 이전의 데이터베이스 엔진은 모든 클러스터형 인덱스도 기본 키여야 하므로 고유해야 하므로 항상 이 옵션이 적용되었다고 가정했습니다. 이제 Windows Server 2003을 기준으로 JET_bitTTForwardOnly 옵션을 지정할 때 중복 항목을 제거하지 않는 임시 테이블을 만들 수 있습니다.

어떤 중복이 이길지, 어떤 중복이 일반적으로 삭제될지는 알 수 없습니다. 그러나 JET_bitTTErrorOnDuplicateInsertion 옵션이 요청되면 임시 테이블에 삽입할 지정된 인덱스 키가 있는 첫 번째 레코드가 항상 승리합니다.

JET_bitTTUpdatable

이 옵션은 임시 테이블이 이전에 삽입된 레코드를 나중에 변경할 수 있을 만큼 유연하도록 요청합니다. 이 기능이 필요하지 않은 경우 요청하지 않는 것이 가장 좋습니다.

이 기능이 요청되지 않은 경우 임시 테이블 관리자는 성능이 향상되는 임시 테이블을 관리하기 위한 전략을 선택할 수 있습니다.

JET_bitTTScrollable

이 옵션은 임시 테이블이 JetMove를 사용하여 임의 순서 및 방향으로 레코드를 검사할 수 있을 만큼 유연하도록 요청합니다.

이 기능이 필요하지 않은 경우 요청하지 않는 것이 가장 좋습니다. 이 기능이 요청되지 않은 경우 임시 테이블 관리자는 성능이 향상되는 임시 테이블을 관리하기 위한 전략을 선택할 수 있습니다.

JET_bitTTSortNullsHigh

이 옵션은 NULL 키 열 값이 NULL이 아닌 키 열 값보다 인덱스 끝에 더 가깝게 정렬되도록 요청합니다.

JET_bitTTIntrinsicLVsOnly

내장 long 값만 허용하도록 요청합니다.

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

ptableid

새로 만든 임시 테이블에서 열린 새 커서를 받을 출력 버퍼입니다.

prgcolumnid

임시 테이블을 만드는 동안 생성된 열 ID의 배열을 수신할 출력 버퍼입니다.

이 배열의 열 ID는 열 정의의 입력 배열과 정확히 일치합니다. 따라서 이 버퍼의 크기는 입력 배열의 크기에 해당해야 합니다.

반환 값

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

반환 코드

설명

JET_errSuccess

작업이 성공적으로 완료되었습니다.

JET_errCannotMaterializeForwardOnlySort

jetOpenTempTable3 은 JET_bitTTForwardOnly 지정되었고 지정된 임시 테이블을 정방향 전용 최적화를 사용하여 만들 수 없으므로 실패했습니다. 이 오류는 Windows Server 2003 이상 릴리스에서만 반환됩니다.

JET_errClientRequestToStopJetService

JetStopService 호출로 인해 세션과 연결된 instance 모든 작업이 중단되었으므로 작업을 완료할 수 없습니다.

JET_errIndexInvalidDef

잘못된 인덱스 정의가 지정되어 인덱스 를 만들 수 없습니다. JetOpenTempTable3 은 다음과 같은 경우 이 오류를 반환합니다.

  • 언어 중립 로캘이 지정됩니다.

  • 잘못된 정규화 플래그 집합이 지정되었습니다.

이 오류는 Windows 2000에서만 반환됩니다.

JET_errInstanceUnavailable

세션과 연결된 instance 해당 데이터의 무결성을 보호하기 위해 모든 데이터에 대한 액세스를 해지해야 하는 심각한 오류가 발생하여 작업을 완료할 수 없습니다. 이 오류는 Windows XP 이상 릴리스에서만 반환됩니다.

JET_errInvalidCodePage

JET_COLUMNDEF 구조체의 cp 멤버가 유효한 코드 페이지로 설정되지 않았습니다. 텍스트 열에 유효한 값은 영어(1252) 및 유니코드(1200)뿐입니다. 값이 0이면 기본값이 사용됩니다(영어, 1252).

JET_errInvalidColumnType

JET_COLUMNDEF 구조체의 coltyp 멤버가 유효한 열 형식으로 설정되지 않았습니다.

JET_errInvalidLanguageId

잘못된 로캘 ID를 사용하려고 했기 때문에 인덱스 를 만들 수 없습니다. 로캘 ID가 완전히 잘못되었거나 연결된 언어 팩이 설치되지 않을 수 있습니다.

JET_errInvalidLCMapStringFlags

잘못된 정규화 플래그 집합을 사용하려고 했기 때문에 인덱스 를 만들 수 없습니다. 이 오류는 Windows XP 이상 릴리스에서만 반환됩니다. Windows 2000에서 정규화 플래그가 잘못되면 대신 JET_errIndexInvalidDef 발생합니다.

JET_errInvalidSesid

세션 핸들이 잘못되었거나 닫힌 세션을 참조합니다. 이 오류는 모든 상황에서 반환되지 않습니다. 핸들은 최상의 노력으로만 유효성이 검사됩니다.

JET_errNotInitialized

세션과 연결된 instance 아직 초기화되지 않았기 때문에 작업을 완료할 수 없습니다.

JET_errOutOfCursors

엔진이 새 커서를 여는 데 필요한 리소스를 할당할 수 없기 때문에 작업이 실패했습니다. 커서 리소스는 JET_paramMaxCursorsJetSetSystemParameter를 사용하여 구성됩니다.

JET_errOutOfMemory

완료할 메모리가 부족하여 작업이 실패했습니다.

호스트 프로세스의 주소 공간이 너무 조각화되면 JetOpenTempTable3에서 JET_errOutOfMemory 반환할 수 있습니다. 임시 테이블 관리자는 저장할 데이터의 양에 관계없이 생성된 모든 임시 테이블에 대해 항상 1MB의 주소 공간 청크를 할당합니다.

JET_errRestoreInProgress

세션과 연결된 instance 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다.

JET_errSessionSharingViolation

동시에 둘 이상의 스레드에 동일한 세션을 사용할 수 없습니다.

이 오류는 Windows XP 이상 릴리스에서만 반환됩니다.

JET_errTermInProgress

세션과 연결된 instance 종료 중이므로 작업을 완료할 수 없습니다.

JET_errTooManyColumns

테이블에 너무 많은 열을 추가하려고 했습니다. 테이블에는 고정 열이 JET_ccolFixedMost 이상, 가변 길이 열은 JET_ccolVarMost 이상, 태그가 지정된 열은 JET_ccolTaggedMost 수 없습니다.

JET_errTooManyOpenIndexes

엔진이 테이블의 인덱스를 캐시하는 데 필요한 리소스를 할당할 수 없기 때문에 작업이 실패했습니다. 스키마를 캐시할 수 있는 인덱스의 수는 JET_paramMaxOpenTables JetSetSystemParameter를 사용하여 구성됩니다.

JET_errTooManyOpenTables

엔진이 테이블의 스키마를 캐시하는 데 필요한 리소스를 할당할 수 없기 때문에 작업이 실패했습니다. 스키마를 캐시할 수 있는 테이블 수는 JET_paramMaxOpenTables JetSetSystemParameter를 사용하여 구성됩니다.

JET_errTooManySorts

엔진이 임시 테이블을 만드는 데 필요한 리소스를 할당할 수 없기 때문에 작업이 실패했습니다. 임시 테이블 리소스는 JET_paramMaxTemporaryTablesJetSetSystemParameter를 사용하여 구성됩니다.

성공하면 새로 만든 임시 테이블에서 열린 커서가 반환됩니다. 임시 데이터베이스의 상태는 새 임시 테이블을 포함하도록 준비됩니다. 데이터베이스 엔진에서 사용 중인 일반 데이터베이스의 상태는 변경되지 않습니다.

실패하면 임시 테이블이 생성되지 않고 커서가 반환되지 않습니다. 임시 데이터베이스의 상태가 변경될 수 있습니다. 데이터베이스 엔진에서 사용 중인 일반 데이터베이스의 상태는 변경되지 않습니다.

요구 사항

요구 사항 값

클라이언트

Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다.

서버

Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다.

머리글

Esent.h에 선언되었습니다.

라이브러리

ESENT.lib를 사용합니다.

DLL

ESENT.dll 필요합니다.

참고 항목

확장 가능한 스토리지 엔진 오류
오류 처리 매개 변수
JET_COLUMNDEF
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_UNICODEINDEX
JetCloseTable
JetCreateTableColumnIndex
JetDupCursor
JetMove
JetOpenTempTable
JetRollback
JetSeek
JetSetSystemParameter
시스템 매개 변수