JET_param 枚举

  • 项目

ESENT 系统参数。

Namespace：Microsoft.Isam.Esent.Interop
装配： Microsoft.Isam.Esent.Interop.dll) 中的 Microsoft.Isam.Esent.Interop (

语法

'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 此参数保留请求的临时表资源数，供实例使用。 此设置将影响可以同时使用多少个临时表。 如果此系统参数设置为零，则不会创建临时数据库，并且任何需要使用临时数据库的活动都将失败。 如果已知不会使用临时数据库，则此设置可用于避免创建临时数据库所需的 I/O。

使用临时表还需要游标资源。
LogFileSize 此参数将配置事务日志文件的大小。 每个事务日志文件的大小都是固定的。 大小等于此系统参数的设置（以 1024 字节为单位）。
LogBuffers 此参数将配置在将日志记录写入事务日志文件之前用于缓存日志记录的内存量。 此参数的单位是保存事务日志文件的卷的扇区大小。 扇区大小几乎始终为 512 字节，因此可以安全地假设单元的大小。 此参数对性能有影响。 当数据库引擎处于繁重的更新负载下时，此缓冲区可能会非常快地充满。 事务日志文件更大的缓存大小对于在如此高负载条件下的良好更新性能至关重要。 对于这种情况，已知默认值太小。 不要将此参数设置为大于 (字节数) 事务日志文件大小的一半的缓冲区。
CircularLog 此参数配置数据库引擎管理事务日志文件的方式。 关闭循环日志记录时，生成的所有事务日志文件将保留在磁盘上，直到不再需要这些文件，因为已执行数据库的完整备份。 启用循环日志记录时，磁盘上仅保留小于当前检查点的事务日志文件。 此模式的好处是无需备份即可停用旧的事务日志文件。
DbExtensionSize 此参数控制每次需要增大以容纳更多数据时添加到数据库文件的空间量。 大小以数据库页为单位。
PageTempDBMin 此参数控制临时数据库的初始大小。 大小以数据库页为单位。 大小为零表示应使用普通数据库的默认大小。 小型应用程序通常需要将临时数据库配置为尽可能小。 将此参数设置为 SystemParameters.PageTempDBSmallest 将尽可能获得最小的临时数据库。
CacheSizeMax 此参数配置数据库页缓存的最大大小。 大小以数据库页为单位。 如果此参数保留为其默认值，则在调用 JetInit 时，缓存的最大大小将设置为物理内存的大小。
CheckpointDepthMax 此参数控制从数据库页缓存中刷新数据库页的方式，以最大程度地减少从崩溃中恢复所需的时间。 参数是一个阈值，以字节为单位，表示崩溃后需要重播多少个事务日志文件。 如果使用 JET_param 启用循环日志记录。CircularLog，此参数还将控制将在磁盘上保留的事务日志文件的大致数量。
OutstandingIOMax 此参数控制主机操作系统中每个磁盘一次可以排队的数据库文件 I/O 数。 此参数的较大值可显著提高大型数据库应用程序的性能。
StartFlushThreshold 此参数控制数据库页缓存何时开始从缓存中逐出页，以便为未缓存的页腾出空间。 当缓存中的页缓冲区数低于此阈值时，将启动后台进程来补充该可用缓冲区池。 此阈值始终相对于JET_paramCacheSizeMax设置的最大缓存大小。 此阈值还必须始终小于JET_paramStopFlushThreshold设置的停止阈值。 开始阈值的距离高度将确定数据库页缓存在应用程序需要它们之前生成可用缓冲区所必须具备的响应时间。 较高的启动阈值将为后台进程提供更多反应时间。 但是，较高的启动阈值意味着更高的停止阈值，这将减小 windows 2000) (修改页或 windows XP 及更高版本) 的所有页面 (数据库页缓存的有效大小。
StopFlushThreshold 此参数控制数据库页缓存何时结束从缓存中逐出页，以便为未缓存的页腾出空间。 当缓存中的页缓冲区数超过此阈值时，启动以补充可用缓冲区池的后台进程将停止。 此阈值始终相对于JET_paramCacheSizeMax设置的最大缓存大小。 此阈值还必须始终大于JET_paramStartFlushThreshold设置的开始阈值。 启动阈值与停止阈值之间的距离会影响后台进程刷新数据库页的效率。 较大的间隔会使写入相邻页面的可能性更大。 但是，高停止阈值将减小修改的页 (Windows 2000) 或 windows XP 及更高版本) 的所有页面 (数据库页缓存的有效大小。
恢复 此参数是控制实例故障恢复的主开关。 如果此参数设置为“开”，则 ARIES 样式恢复将用于在进程或计算机崩溃时使实例中的所有数据库处于一致状态。 如果此参数设置为“Off”，则实例中的所有数据库都将得到管理，而没有故障恢复的好处。 也就是说，如果在进程退出或计算机关闭之前未使用 JetTerm 彻底关闭实例，则该实例中所有数据库的内容都将损坏。
EnableOnlineDefrag 此参数控制使用 JetDefragment (JET_SESID、JET_DBID、String、Int32、Int32、DefragGrbit) 和 JetDefragment2 (JET_SESID、JET_DBID、String、Int32、Int32、Int32、JET_CALLBACK、DefragGrbit) 启动联机碎片整理 的行为。
CacheSize 此参数可用于控制运行时数据库页缓存的大小。 通常，缓存会根据数据库和计算机活动级别自动调整其大小。 如果应用程序将此参数设置为零，则缓存将以这种方式调整自己的大小。 但是，如果应用程序将此参数设置为非零值，则缓存将自行调整为该目标大小。
EnableIndexChecking 如果此参数为 true，则会在 JetAttachDatabase 时间检查每个数据库，以查找使用操作系统中较旧版本的 NLS 库生成的 Unicode 键列上的索引。 必须执行此操作，因为数据库引擎会保留 LCMapStringW 生成的排序键，并且这些排序键的值会从发布更改为发布。 如果检测到主索引处于此状态，则 JetAttachDatabase 将始终失败并JET_err。PrimaryIndexCorrupted。 如果检测到任何辅助索引处于此状态，则有两种可能的结果。 如果将 AttachDatabaseGrbit.DeleteCorruptIndexes 传递给 JetAttachDatabase，则将删除这些索引，并从 JetAttachDatabase 返回JET_wrnCorruptIndexDeleted。 应用程序需要重新创建这些索引。 如果 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 命名空间