перечисление 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. ChK по умолчанию, так как EDB является базовым именем по умолчанию.
EventSource Этот параметр предоставляет конкретную строку приложения, которая будет добавлена в любые сообщения журнала событий, создаваемые ядром СУБД. Это позволяет легко сопоставить сообщения журнала событий с исходным приложением. По умолчанию будет использоваться исполняемое имя ведущего приложения.
MaxSessions Этот параметр резервирует запрошенное количество ресурсов сеанса для использования экземпляром. Ресурс сеанса напрямую соответствует типу данных JET_SESID. Этот параметр влияет на то, сколько сеансов можно использовать одновременно.
MaxOpenTables Этот параметр резервирует запрошенное количество ресурсов дерева B+ для использования экземпляром. Этот параметр влияет на количество таблиц, которые можно использовать одновременно.
MaxCursors Этот параметр резервирует запрошенное количество ресурсов курсора для использования экземпляром. Ресурс курсора напрямую соответствует типу данных JET_TABLEID. Этот параметр влияет на то, сколько курсоров можно использовать одновременно. Ресурс курсора нельзя совместно использовать различными сеансами, поэтому этот параметр должен иметь достаточно большое значение, чтобы каждый сеанс может использовать столько курсоров, сколько требуется.
MaxVerPages Этот параметр резервирует запрошенное количество страниц хранилища версий для использования экземпляром.
MaxTemporaryTables Этот параметр резервирует запрошенное количество временных ресурсов таблицы для использования экземпляром. Этот параметр влияет на то, сколько временных таблиц можно использовать одновременно. Если для этого системного параметра задано нулевое значение, то не будет создана временная база данных, и все действия, требующие использования временной базы данных, завершатся сбоем. Этот параметр может быть полезен, чтобы избежать ввода-вывода, необходимого для создания временной базы данных, если известно, что она не будет использоваться.

Для использования временной таблицы также требуется ресурс курсора.

LogFileSize Этот параметр настраивает размер файлов журнала транзакций. Каждый файл журнала транзакций является фиксированным размером. Размер равен параметру этого системного параметра в единицах 1024 байта.
LogBuffers Этот параметр настроит объем памяти, используемый для кэширования записей журнала, прежде чем они будут записаны в файл журнала транзакций. Единицей для этого параметра является размер сектора тома, в котором хранятся файлы журнала транзакций. Размер сектора почти всегда составляет 512 байтов, поэтому можно предположить, что размер единицы. Этот параметр влияет на производительность. Когда ядро СУБД находится под большой нагрузкой на обновление, этот буфер может быть заполнен очень быстро. Больший размер кэша для файла журнала транзакций имеет решающее значение для обеспечения высокой производительности обновления при таком условии высокой нагрузки. Значение по умолчанию, как известно, слишком мало для этого случая. Не устанавливайте этот параметр на число буферов, размер которых больше (в байтах), чем половина размера файла журнала транзакций.
Циклический журнал Этот параметр настраивает управление файлами журналов транзакций ядром СУБД. Если циклическое ведение журнала отключено, все созданные файлы журнала транзакций сохраняются на диске до тех пор, пока они больше не понадобятся, так как будет выполнена полная резервная копия базы данных. Если циклическое ведение журнала включено, на диске сохраняются только файлы журнала транзакций, которые моложе текущей контрольной точки. Преимущество этого режима заключается в том, что резервные копии не требуются для прекращения использования старых файлов журнала транзакций.
DbExtensionSize Этот параметр управляет объемом пространства, добавляемого в файл базы данных каждый раз, когда он должен увеличиваться для размещения большего объема данных. Размер находится на страницах базы данных.
PageTempDBMin Этот параметр управляет начальным размером временной базы данных. Размер находится на страницах базы данных. Нулевой размер указывает, что следует использовать размер обычной базы данных по умолчанию. Часто для небольших приложений рекомендуется настроить как можно меньше временную базу данных. Если задать для этого параметра значение SystemParameters.PageTempDBSmallest, будет достигнута самая небольшая временная база данных.
CacheSizeMax Этот параметр настраивает максимальный размер кэша страниц базы данных. Размер находится на страницах базы данных. Если этот параметр остается значением по умолчанию, максимальный размер кэша будет установлен на размер физической памяти при вызове JetInit.
CheckpointDepthMax Этот параметр управляет тем, как агрессивно страницы базы данных сбрасываются из кэша страниц базы данных, чтобы свести к минимуму время, необходимое для восстановления после сбоя. Параметр является пороговым значением в байтах для того, сколько файлов журнала транзакций потребуется воспроизвести после сбоя. Если циклическое ведение журнала включено с помощью JET_param. Циклический журнал затем этот параметр также будет контролировать приблизительное количество файлов журнала транзакций, которые будут храниться на диске.
OutstandingIOMax Этот параметр определяет, сколько файлов базы данных может быть помещено в очередь на диск в операционной системе узла одновременно. Большее значение для этого параметра может значительно повысить производительность большого приложения базы данных.
StartFlushThreshold Этот параметр управляет тем, когда кэш страниц базы данных начинает вытеснивать страницы из кэша, чтобы освободить место для страниц, которые не кэшируются. Когда количество буферов страниц в кэше снижается ниже этого порога, фоновый процесс будет запущен для пополнения этого пула доступных буферов. Это пороговое значение всегда соответствует максимальному размеру кэша, заданному JET_paramCacheSizeMax. Это пороговое значение также всегда должно быть меньше порога остановки, заданного JET_paramStopFlushThreshold. Высота расстояния порогового значения начального значения определяет время отклика, необходимое кэшу страниц базы данных для создания доступных буферов, прежде чем приложение им потребуется. Высокий порог начала даст фоновому процессу больше времени для реагирования. Тем не менее, высокий порог запуска подразумевает более высокое пороговое значение остановки, что приведет к снижению эффективного размера кэша страниц базы данных для измененных страниц (Windows 2000) или для всех страниц (Windows XP и более поздних версий).
StopFlushThreshold Этот параметр определяет, когда кэш страниц базы данных завершает вытеснение страниц из кэша, чтобы освободить место для страниц, которые не кэшируются. Когда количество буферов страниц в кэше превышает это пороговое значение, фоновый процесс, который был запущен для пополнения этого пула доступных буферов, останавливается. Это пороговое значение всегда соответствует максимальному размеру кэша, заданному JET_paramCacheSizeMax. Это пороговое значение также должно быть больше начального порога, заданного JET_paramStartFlushThreshold. Расстояние между пороговым значением начала и порогом остановки влияет на эффективность, с которой страницы базы данных очищаются фоновым процессом. Больший разрыв сделает его более вероятным, что записи на соседние страницы могут быть объединены. Однако пороговое значение высокой остановки уменьшит действующий размер кэша страниц базы данных для измененных страниц (Windows 2000) или для всех страниц (Windows XP и более поздних версий).
Восстановление Этот параметр является главным коммутатором, который управляет аварийным восстановлением для экземпляра. Если этот параметр имеет значение "Вкл.", восстановление стиля ARIES будет использоваться для переноса всех баз данных в экземпляр в согласованное состояние в случае сбоя процесса или компьютера. Если этот параметр имеет значение "Выкл.", все базы данных в экземпляре будут управляться без преимущества аварийного восстановления. Это значит, что если экземпляр не завершает работу с помощью JetTerm до завершения процесса или завершения работы компьютера, содержимое всех баз данных в этом экземпляре будет повреждено.
EnableOnlineDefrag Этот параметр управляет поведением дефрагментации в сети при запуске с помощью JetDefragment(JET_SESID, JET_DBID, String, Int32, Int32, DefragGrbit) и JetDefragment2(JET_SESID, JET_DBID, String, Int32, Int32, JET_CALLBACK, DefragGrbit).
CacheSize Этот параметр можно использовать для управления размером кэша страниц базы данных во время выполнения. Обычно кэш автоматически настраивает его размер как функцию уровней активности базы данных и компьютера. Если приложение устанавливает для этого параметра нулевое значение, кэш будет настраивать собственный размер таким образом. Однако если приложение присваивает этому параметру значение, отличное от нуля, кэш будет настраиваться на этот целевой размер.
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 Этот параметр управляет тем, что происходит при возникновении исключения ядром СУБД или кодом, вызываемым ядром СУБД. Если задано значение JET_ExceptionMsgBox, в Windows необработанным фильтром исключений будет выдано любое исключение. Это приведет к тому, что исключение обрабатывается как сбой приложения. Цель состоит в том, чтобы код приложения не пытался ошибочно перехватывать и игнорировать исключение, созданное ядром СУБД. Это не может быть разрешено, так как может произойти повреждение базы данных. Если приложение хочет правильно обработать эти исключения, можно отключить защиту, задав для этого параметра значение JET_ExceptionNone.
CreatePathIfNotExist Если для этого параметра задано значение true, то все папки, отсутствующие в пути к файловой системе, используемому ядром СУБД, будут автоматически созданы. В противном случае операция, использующая отсутствующий путь к файловой системе, завершится ошибкой с JET_err. InvalidPath.
OneDatabasePerSession Если этот параметр имеет значение true, можно одновременно открыть только одну базу данных с помощью JetOpenDatabase в заданном сеансе. Временная база данных исключается из этого ограничения.
MaxInstances Этот параметр управляет максимальным количеством экземпляров, которые можно создать в одном процессе.
VersionStoreTaskQueueMax Этот параметр управляет количеством рабочих элементов фоновой очистки, которые можно помещать в пул потоков ядра СУБД в любое время.

См. также раздел

Справочник

Пространство имен Microsoft.Isam.Esent.Interop