Перечисление 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 | Этот параметр резервирует запрошенное количество временных ресурсов таблицы для использования экземпляром . Этот параметр влияет на то, сколько временных таблиц можно использовать одновременно. Если для этого системного параметра задано значение 0, то временная база данных не будет создана, и любые действия, требующие использования временной базы данных, завершатся сбоем. Этот параметр может быть полезен, чтобы избежать операций ввода-вывода, необходимых для создания временной базы данных, если известно, что она не будет использоваться. Для использования временной таблицы также требуется ресурс курсора. |
| LogFileSize | Этот параметр настраивает размер файлов журнала транзакций. Каждый файл журнала транзакций имеет фиксированный размер. Размер равен значению этого системного параметра в единицах 1024 байта. |
| LogBuffers | Этот параметр настраивает объем памяти, используемой для кэширования записей журнала перед их записью в файл журнала транзакций. Единицей измерения для этого параметра является размер сектора тома, в котором хранятся файлы журнала транзакций. Размер сектора почти всегда составляет 512 байт, поэтому можно с уверенностью предположить, что размер для единицы. Этот параметр влияет на производительность. Если ядро СУБД находится под большой нагрузкой на обновление, этот буфер может быть заполнен очень быстро. Больший размер кэша для файла журнала транзакций имеет решающее значение для обеспечения высокой производительности обновления при такой высокой нагрузке. Известно, что значение по умолчанию слишком мало для этого случая. Не устанавливайте для этого параметра число буферов, размер которых больше (в байтах), чем вдвое меньше размера файла журнала транзакций. |
| CircularLog | Этот параметр настраивает управление файлами журнала транзакций ядром СУБД. Если циклическое ведение журнала отключено, все созданные файлы журнала транзакций сохраняются на диске до тех пор, пока они больше не будут нужны, так как была выполнена полная резервная копия базы данных. Если циклическое ведение журнала включено, на диске сохраняются только файлы журнала транзакций, которые моложе текущей контрольной точки. Преимущество этого режима заключается в том, что для прекращения использования старых файлов журнала транзакций не требуется создавать резервные копии. |
| DbExtensionSize | Этот параметр управляет объемом пространства, добавляемого в файл базы данных при каждом его росте для размещения большего объема данных. Размер находится на страницах базы данных. |
| PageTempDBMin | Этот параметр управляет начальным размером временной базы данных. Размер находится на страницах базы данных. Нулевой размер указывает, что следует использовать размер обычной базы данных по умолчанию. Часто требуется, чтобы небольшие приложения настраивали временную базу данных как можно меньше. Если задать для этого параметра значение SystemParameters.PageTempDBSmallest, будет достигнута наименьшая временная база данных. |
| CacheSizeMax | Этот параметр настраивает максимальный размер кэша страниц базы данных. Размер находится на страницах базы данных. Если этот параметр имеет значение по умолчанию, максимальный размер кэша будет установлен в размере физической памяти при вызове JetInit. |
| CheckpointDepthMax | Этот параметр определяет, насколько агрессивно страницы базы данных очищаются из кэша страниц базы данных, чтобы свести к минимуму время, необходимое для восстановления после сбоя. Параметр представляет собой пороговое значение в байтах о том, сколько файлов журнала транзакций потребуется воспроизвести после сбоя. Если циклическое ведение журнала включено с помощью JET_param. Затем CircularLog этот параметр также будет контролировать приблизительное количество файлов журнала транзакций, которые будут храниться на диске. |
| OutstandingIOMax | Этот параметр определяет, сколько файловых операций ввода-вывода базы данных можно поместить в очередь на каждый диск в операционной системе узла одновременно. Большее значение для этого параметра может значительно повысить производительность большого приложения базы данных. |
| StartFlushThreshold | Этот параметр определяет, когда кэш страниц базы данных начинает вытеснивать страницы из кэша, чтобы освободить место для страниц, которые не кэшируются. Когда количество буферов страниц в кэше падает ниже этого порогового значения, начнется фоновый процесс пополнения этого пула доступных буферов. Это пороговое значение всегда зависит от максимального размера кэша, заданного JET_paramCacheSizeMax. Это пороговое значение также всегда должно быть меньше порога остановки, заданного JET_paramStopFlushThreshold. Высота расстояния порога запуска определяет время отклика, необходимое кэшу страниц базы данных для создания доступных буферов, прежде чем они потребуются приложению. Высокий порог начала даст фоновому процессу больше времени на реагирование. Однако высокий порог запуска подразумевает более высокое пороговое значение остановки, что приведет к уменьшению эффективного размера кэша страниц базы данных для измененных страниц (Windows 2000) или для всех страниц (Windows XP и более поздних версий). |
| StopFlushThreshold | Этот параметр определяет, когда кэш страниц базы данных завершает вытеснение страниц из кэша, чтобы освободить место для страниц, которые не кэшируются. Когда количество буферов страниц в кэше превышает это пороговое значение, фоновый процесс, который был запущен для пополнения этого пула доступных буферов, останавливается. Это пороговое значение всегда зависит от максимального размера кэша, заданного JET_paramCacheSizeMax. Это пороговое значение также всегда должно быть больше начального порога, заданного JET_paramStartFlushThreshold. Расстояние между пороговым значением начала и порогом остановки влияет на эффективность очистки страниц базы данных в фоновом процессе. Больший разрыв сделает более вероятным объединение операций записи на соседние страницы. Однако высокий порог остановки уменьшит фактический размер кэша страниц базы данных для измененных страниц (Windows 2000) или для всех страниц (Windows XP и более поздних версий). |
| Восстановление | Этот параметр является параметром master, который управляет аварийным восстановлением для экземпляра. Если для этого параметра задано значение "Включено", восстановление стиля 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 | Этот параметр определяет количество рабочих элементов фоновой очистки, которые можно помещать в очередь в пул потоков ядра СУБД в любой момент времени. |
См. также раздел
Ссылка
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по