JetGrowDatabase 함수

아티클
06/13/2023

적용 대상: Windows | Windows Server

JetGrowDatabase 함수

JetGrowDatabase 함수는 현재 열려 있는 데이터베이스의 크기를 확장합니다.

    JET_ERR JET_API JetGrowDatabase(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          unsigned long cpg,
      __in          unsigned long* pcpgReal
    );

매개 변수

sesid

API 호출에 사용할 데이터베이스 세션 컨텍스트입니다.

dbid

확장할 데이터베이스입니다.

포장 소비재

원하는 데이터베이스 크기(페이지)입니다.

pcpgReal

API 호출 후 데이터베이스의 크기를 페이지 단위로 받는 숫자에 대한 포인터입니다. API 호출이 실패하면 pcpgReal 의 콘텐츠가 정의되지 않습니다.

반환 값

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

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errDiskFull	볼륨에 증가 작업을 수행할 수 있는 여유 공간이 부족합니다.
JET_errDiskIO	JetSetDatabaseSize에서 파일 관련 오류가 반환되었습니다. 반환될 수 있는 다른 파일 관련 오류에 대한 자세한 내용은 JetSetDatabaseSize를 참조하세요.

설명

대량의 데이터를 삽입하기 전에 JetGrowDatabase 가 호출되면 데이터베이스 파일은 하나의 작업으로 확장됩니다. 이렇게 하면 데이터베이스 파일이 파일 시스템 수준에서 조각화될 가능성을 줄이고 데이터베이스 파일을 늘려야 하는 횟수도 줄어듭니다. 데이터베이스 파일을 한 번 증가시키는 것이 여러 번 증가하는 것보다 더 빠를 수 있습니다.

파일 증가만 현재 지원됩니다. 파일을 축소하려면 esentutl.exe 유틸리티 프로그램의 조각 모음 기능을 사용합니다.

열리지 않은 데이터베이스의 크기를 설정하려면 JetSetDatabaseSize를 참조하세요.

파일 크기가 pcpgReal에서 반환되는 페이지 수와 일치하지 않을 수 있습니다. pcpgReal에 계산되지 않을 수 있는 두 개의 추가 예약 페이지가 있습니다.

요구 사항

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

참고 항목

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize

JetGrowDatabase 함수