JET_param 열거형

ESENT 시스템 매개 변수입니다.

네임스페이스: Microsoft.Isam.Esent.Interop
어셈블리: Microsoft.Isam.Esent.Interop(Microsoft.Isam.Esent.Interop.dll)

구문

'Declaration
Public Enumeration JET_param
'Usage
Dim instance As JET_param
public enum JET_param

멤버

멤버 이름 설명
SystemPath 이 매개 변수는 인스턴스에 대한 검사점 파일을 포함할 폴더의 상대 또는 절대 파일 시스템 경로를 나타냅니다. 경로는 대상 경로가 폴더임을 나타내는 백슬래시 문자로 종료해야 합니다.
TempPath 이 매개 변수는 인스턴스에 대한 임시 데이터베이스를 포함할 폴더 또는 파일의 상대 또는 절대 파일 시스템 경로를 나타냅니다. 임시 데이터베이스를 포함할 폴더에 대한 경로인 경우 백슬래시 문자로 종료해야 합니다.
Logfilepath 이 매개 변수는 인스턴스에 대한 트랜잭션 로그를 포함할 폴더의 상대 또는 절대 파일 시스템 경로를 나타냅니다. 경로는 대상 경로가 폴더임을 나타내는 백슬래시 문자로 종료해야 합니다.
Basename 이 매개 변수는 데이터베이스 엔진에서 사용하는 많은 파일에 사용되는 세 개의 문자 접두사로 설정합니다. 예를 들어 검사점 파일을 EDB라고 합니다. EDB가 기본 기본 이름이기 때문에 기본적으로 CHK입니다.
EventSource 이 매개 변수는 데이터베이스 엔진에서 내보내는 이벤트 로그 메시지에 추가될 애플리케이션별 문자열을 제공합니다. 이렇게 하면 원본 애플리케이션과 이벤트 로그 메시지의 상관 관계를 쉽게 할 수 있습니다. 기본적으로 호스트 애플리케이션 실행 파일 이름이 사용됩니다.
MaxSessions 이 매개 변수는 인스턴스에서 사용할 세션 리소스의 요청된 수를 예약합니다. 세션 리소스는 JET_SESID 데이터 형식에 직접 해당합니다. 이 설정은 동시에 사용할 수 있는 세션 수에 영향을 미칩니다.
MaxOpenTables 이 매개 변수는 인스턴스에서 사용할 요청된 수의 B+ 트리 리소스를 예약합니다. 이 설정은 동시에 사용할 수 있는 테이블 수에 영향을 미칩니다.
MaxCursors 이 매개 변수는 인스턴스에서 사용할 요청된 커서 리소스 수를 예약합니다. 커서 리소스는 JET_TABLEID 데이터 형식에 직접 해당합니다. 이 설정은 동시에 사용할 수 있는 커서 수에 영향을 미칩니다. 커서 리소스는 서로 다른 세션에서 공유할 수 없으므로 각 세션에서 필요한 만큼 커서를 사용할 수 있도록 이 매개 변수를 충분히 큰 값으로 설정해야 합니다.
MaxVerPages 이 매개 변수는 인스턴스에서 사용할 요청된 버전 저장소 페이지 수를 예약합니다.
MaxTemporaryTables 이 매개 변수는 인스턴스에서 사용할 요청된 수의 임시 테이블 리소스를 예약합니다. 이 설정은 동시에 사용할 수 있는 임시 테이블 수에 영향을 미칩니다. 이 시스템 매개 변수를 0으로 설정하면 임시 데이터베이스가 생성되지 않으며 임시 데이터베이스를 사용해야 하는 모든 작업이 실패합니다. 이 설정은 사용되지 않을 것으로 알려진 경우 임시 데이터베이스를 만드는 데 필요한 I/O를 방지하는 데 유용할 수 있습니다.

임시 테이블을 사용하려면 커서 리소스도 필요합니다.

LogFileSize 이 매개 변수는 트랜잭션 로그 파일의 크기를 구성합니다. 각 트랜잭션 로그 파일은 고정 크기입니다. 크기는 1024바이트 단위로 이 시스템 매개 변수의 설정과 같습니다.
LogBuffers 이 매개 변수는 트랜잭션 로그 파일에 기록되기 전에 로그 레코드를 캐시하는 데 사용되는 메모리 양을 구성합니다. 이 매개 변수의 단위는 트랜잭션 로그 파일을 보유하는 볼륨의 섹터 크기입니다. 섹터 크기는 거의 항상 512바이트이므로 단위의 크기를 가정해도 안전합니다. 이 매개 변수는 성능에 영향을 미칩니다. 데이터베이스 엔진이 업데이트 로드가 많은 경우 이 버퍼가 매우 빠르게 가득 찼을 수 있습니다. 트랜잭션 로그 파일의 캐시 크기가 클수록 높은 부하 조건에서 좋은 업데이트 성능이 중요합니다. 이 경우 기본값이 너무 작은 것으로 알려져 있습니다. 이 매개 변수를 트랜잭션 로그 파일 크기의 절반보다 큰 버퍼 수(바이트)로 설정하지 마십시오.
CircularLog 이 매개 변수는 데이터베이스 엔진에서 트랜잭션 로그 파일을 관리하는 방법을 구성합니다. 순환 로깅이 해제된 경우 생성된 모든 트랜잭션 로그 파일은 데이터베이스의 전체 백업이 수행되었으므로 더 이상 필요하지 않을 때까지 디스크에 유지됩니다. 순환 로깅이 켜지면 현재 검사점보다 더 적은 트랜잭션 로그 파일만 디스크에 유지됩니다. 이 모드의 이점은 이전 트랜잭션 로그 파일을 사용하려면 백업이 필요하지 않다는 것입니다.
DbExtensionSize 이 매개 변수는 더 많은 데이터를 수용하기 위해 확장해야 할 때마다 데이터베이스 파일에 추가되는 공간의 양을 제어합니다. 크기는 데이터베이스 페이지에 있습니다.
PageTempDBMin 이 매개 변수는 임시 데이터베이스의 초기 크기를 제어합니다. 크기는 데이터베이스 페이지에 있습니다. 크기가 0이면 일반 데이터베이스의 기본 크기를 사용해야 함을 나타냅니다. 작은 애플리케이션에서 임시 데이터베이스를 가능한 한 작게 구성하는 것이 바람직한 경우가 많습니다. 이 매개 변수를 SystemParameters.PageTempDBSmallest로 설정하면 가능한 가장 작은 임시 데이터베이스를 얻을 수 있습니다.
CacheSizeMax 이 매개 변수는 데이터베이스 페이지 캐시의 최대 크기를 구성합니다. 크기는 데이터베이스 페이지에 있습니다. 이 매개 변수를 기본값으로 두면 JetInit가 호출될 때 캐시의 최대 크기가 실제 메모리 크기로 설정됩니다.
CheckpointDepthMax 이 매개 변수는 데이터베이스 페이지 캐시에서 데이터베이스 페이지를 적극적으로 플러시하는 방법을 제어하여 크래시로부터 복구하는 데 걸리는 시간을 최소화합니다. 매개 변수는 크래시 후 재생해야 하는 트랜잭션 로그 파일 수에 대한 임계값(바이트)입니다. 순환 로깅을 사용하는 경우 JET_param. 그런 다음 CircularLog 이 매개 변수는 디스크에 보존될 대략적인 트랜잭션 로그 파일의 양을 제어합니다.
OutstandingIOMax 이 매개 변수는 호스트 운영 체제에서 디스크당 큐에 대기할 수 있는 데이터베이스 파일 I/Os의 개수를 한 번에 제어합니다. 이 매개 변수의 값이 클수록 큰 데이터베이스 애플리케이션의 성능에 크게 도움이 될 수 있습니다.
StartFlushThreshold 이 매개 변수는 데이터베이스 페이지 캐시가 캐시에서 페이지를 제거하기 시작하는 시점을 제어하여 캐시되지 않은 페이지를 위한 공간을 확보합니다. 캐시의 페이지 버퍼 수가 이 임계값 아래로 떨어지면 백그라운드 프로세스가 시작되어 사용 가능한 버퍼 풀을 보충합니다. 이 임계값은 항상 JET_paramCacheSizeMax 설정된 최대 캐시 크기를 기준으로 합니다. 또한 이 임계값은 항상 JET_paramStopFlushThreshold 설정된 중지 임계값보다 낮아야 합니다. 시작 임계값의 거리 높이에 따라 애플리케이션에 필요하기 전에 데이터베이스 페이지 캐시에서 사용 가능한 버퍼를 생성해야 하는 응답 시간이 결정됩니다. 시작 임계값이 높을수록 백그라운드 프로세스에 더 많은 반응 시간이 부여됩니다. 그러나 높은 시작 임계값은 더 높은 중지 임계값을 의미하며 이는 수정된 페이지(Windows 2000) 또는 모든 페이지(WINDOWS XP 이상)에 대한 데이터베이스 페이지 캐시의 유효 크기를 줄입니다.
StopFlushThreshold 이 매개 변수는 데이터베이스 페이지 캐시가 캐시에서 페이지 제거를 종료하여 캐시되지 않은 페이지를 위한 공간을 확보할 때를 제어합니다. 캐시의 페이지 버퍼 수가 이 임계값을 초과하면 사용 가능한 버퍼 풀을 보충하기 위해 시작된 백그라운드 프로세스가 중지됩니다. 이 임계값은 항상 JET_paramCacheSizeMax 설정된 최대 캐시 크기를 기준으로 합니다. 또한 이 임계값은 항상 JET_paramStartFlushThreshold 설정된 시작 임계값보다 커야 합니다. 시작 임계값과 중지 임계값 사이의 거리는 백그라운드 프로세스에 의해 데이터베이스 페이지가 플러시되는 효율성에 영향을 미칩니다. 간격이 크면 인접 페이지에 대한 쓰기가 결합될 가능성이 높아질 수 있습니다. 그러나 높은 중지 임계값은 수정된 페이지(Windows 2000) 또는 모든 페이지(Windows XP 이상)에 대한 데이터베이스 페이지 캐시의 유효 크기를 줄입니다.
복구 이 매개 변수는 인스턴스에 대한 크래시 복구를 제어하는 마스터 스위치입니다. 이 매개 변수를 "On"으로 설정하면 ARIES 스타일 복구를 사용하여 프로세스 또는 컴퓨터 크래시 발생 시 인스턴스의 모든 데이터베이스를 일관된 상태로 가져옵니다. 이 매개 변수를 "끄기"로 설정하면 인스턴스의 모든 데이터베이스가 크래시 복구의 이점 없이 관리됩니다. 즉, 프로세스가 종료되거나 컴퓨터가 종료되기 전에 JetTerm을 사용하여 인스턴스가 완전히 종료되지 않으면 해당 인스턴스에 있는 모든 데이터베이스의 내용이 손상됩니다.
EnableOnlineDefrag 이 매개 변수는 JetDefragment(JET_SESID, JET_DBID, String, Int32, Int32, DefragGrbit)JetDefragment2(JET_SESID, JET_DBID, String, Int32, Int32, JET_CALLBACK, DefragGrbit)를사용하여 시작할 때 온라인 조각 모음의 동작을 제어합니다.
CacheSize 이 매개 변수는 런타임에 데이터베이스 페이지 캐시의 크기를 제어하는 데 사용할 수 있습니다. 일반적으로 캐시는 데이터베이스 및 컴퓨터 작업 수준의 함수로 크기를 자동으로 조정합니다. 애플리케이션이 이 매개 변수를 0으로 설정하면 캐시는 이러한 방식으로 자체 크기를 조정합니다. 그러나 애플리케이션이 이 매개 변수를 0이 아닌 값으로 설정하면 캐시가 해당 대상 크기로 조정됩니다.
EnableIndexChecking 이 매개 변수가 true이면 모든 데이터베이스가 JetAttachDatabase 시간에 운영 체제에서 이전 버전의 NLS 라이브러리를 사용하여 빌드된 유니코드 키 열에 대한 인덱스에 대해 검사됩니다. 데이터베이스 엔진이 LCMapStringW에 의해 생성된 정렬 키를 유지하며 이러한 정렬 키의 값이 릴리스에서 릴리스로 변경되기 때문에 이 작업을 수행해야 합니다. 기본 인덱스 이 상태에 있는 것으로 감지되면 JetAttachDatabase는 항상 JET_err 함께 실패합니다. PrimaryIndexCorrupted. 보조 인덱스가 이 상태에 있는 것으로 감지되면 두 가지 가능한 결과가 있습니다. AttachDatabaseGrbit.DeleteCorruptIndexes가 JetAttachDatabase에 전달된 경우 이러한 인덱스가 삭제되고 JET_wrnCorruptIndexDeleted JetAttachDatabase에서 반환됩니다. 이러한 인덱스는 애플리케이션에서 다시 만들어야 합니다. AttachDatabaseGrbit.DeleteCorruptIndexes가 JetAttachDatabase에 전달되지 않은 경우 JET_errSecondaryIndexCorrupted 호출이 실패합니다.
EventSourceKey 이 매개 변수는 데이터베이스 엔진이 이벤트 로그 메시지에 사용하는 이벤트 로그를 제어하는 데 사용할 수 있습니다. 기본적으로 모든 이벤트 로그 메시지는 애플리케이션 이벤트 로그로 이동합니다. 다른 이벤트 로그에 대한 레지스트리 키 이름이 구성된 경우 이벤트 로그 메시지가 대신 이동합니다.
NoInformationEvent 이 매개 변수가 true이면 일반적으로 데이터베이스 엔진에서 생성되는 정보 이벤트 로그 메시지가 표시되지 않습니다.
EventLoggingLevel 데이터베이스 엔진에서 이벤트 로그에 내보내는 이벤트 로그 메시지의 세부 수준을 구성합니다. 숫자가 높을수록 더 자세한 이벤트 로그 메시지가 생성됩니다.
DeleteOutOfRangeLogs 일시 복구 중에 일치하지 않는 로그 파일(생성별)을 삭제합니다.
CacheSizeMin 이 매개 변수는 데이터베이스 페이지 캐시의 최소 크기를 구성합니다. 크기는 데이터베이스 페이지에 있습니다.
PreferredVerPages 이 매개 변수는 데이터베이스 엔진에서 버전 페이지의 임의 사용을 제어하는 MaxVerPages에 상대적인 임계값을 나타냅니다. 버전 저장소의 크기가 이 임계값을 초과하는 경우 데이터베이스에서 삭제된 공간 회수와 같은 선택적 백그라운드 작업에만 사용되는 모든 정보는 트랜잭션 정보를 위한 공간을 유지하기 위해 대신 삭제됩니다.
DatabasePageSize 이 매개 변수는 데이터베이스의 페이지 크기를 구성합니다. 페이지 크기는 데이터베이스 파일에 대해 가능한 최소 공간 할당 단위입니다. 데이터베이스 페이지 크기는 데이터베이스의 개별 레코드 크기에 대한 상한을 설정하기 때문에 매우 중요합니다.

현재 프로세스당 하나의 데이터베이스 페이지 크기만 지원됩니다. 즉, 데이터베이스 엔진을 사용하는 다른 애플리케이션이 포함된 단일 프로세스에 있는 경우 모두 데이터베이스 페이지 크기에 동의해야 합니다.

ErrorToString 이 매개 변수는 JET_ERR 문자열로 변환하는 데 사용할 수 있습니다. JetGetSystemParameter에서만 사용해야 합니다.
RuntimeCallback JET_CALLBACK 대리자를 통해 엔진을 구성합니다. FreeCursorLS, FreeTableLS또는 Null등의 이유로 이 콜백을 호출할 수 있습니다. 자세한 내용은 JetSetLS(JET_SESID, JET_TABLEID, JET_LS, LsGrbit)를 참조하세요. 이 매개 변수는 현재 검색할 수 없습니다.
CleanupMismatchedLogFiles 이 매개 변수는 데이터베이스 엔진이 구성된 것과 다른 크기의 디스크에서 트랜잭션 로그 파일 사용을 시작하도록 구성된 경우 JetInit의 결과를 제어합니다. 일반적으로 JetInit(JET_INSTANCE)은 데이터베이스를 성공적으로 복구하지만 LogFileSizeMismatchDatabasesConsistent로 실패하여 로그 파일 크기가 잘못 구성되었음을 나타냅니다. 그러나 이 매개 변수가 true로 설정된 경우 데이터베이스 엔진은 모든 이전 로그 파일을 자동으로 삭제하고 구성된 로그 파일 크기를 사용하여 새 트랜잭션 로그 파일 집합을 시작합니다. 이 매개 변수는 애플리케이션이 트랜잭션 로그 파일 크기를 투명하게 변경하면서도 업그레이드 및 복원 시나리오에서 투명하게 작동하려는 경우에 유용합니다.
ExceptionAction 이 매개 변수는 데이터베이스 엔진 또는 데이터베이스 엔진에서 호출하는 코드에서 예외가 throw되면 발생하는 작업을 제어합니다. JET_ExceptionMsgBox 설정하면 처리되지 않은 Windows 예외 필터에 예외가 throw됩니다. 그러면 예외가 애플리케이션 오류로 처리됩니다. 애플리케이션 코드가 데이터베이스 엔진에서 생성된 예외를 잘못 catch하고 무시하지 않도록 하기 위한 것입니다. 데이터베이스 손상이 발생할 수 있으므로 이 작업을 허용할 수 없습니다. 애플리케이션에서 이러한 예외를 제대로 처리하려는 경우 이 매개 변수를 JET_ExceptionNone 설정하여 보호를 사용하지 않도록 설정하면 됩니다.
CreatePathIfNotExist 이 매개 변수를 true로 설정하면 데이터베이스 엔진에서 사용 중인 파일 시스템 경로에 없는 모든 폴더가 자동으로 만들어집니다. 그렇지 않으면 누락된 파일 시스템 경로를 사용하는 작업이 JET_err 실패합니다. InvalidPath.
OneDatabasePerSession 이 매개 변수가 true이면 지정된 세션에서 JetOpenDatabase를 사용하여 한 번에 하나의 데이터베이스만 열 수 있습니다. 임시 데이터베이스는 이 제한에서 제외됩니다.
MaxInstances 이 매개 변수는 단일 프로세스에서 만들 수 있는 최대 인스턴스 수를 제어합니다.
VersionStoreTaskQueueMax 이 매개 변수는 데이터베이스 엔진 스레드 풀에 한 번에 큐에 대기할 수 있는 백그라운드 정리 작업 항목의 수를 제어합니다.

참고 항목

참조

Microsoft.Isam.Esent.Interop 네임스페이스