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 启用循环日志记录。然后,此参数还将控制将在磁盘上保留的大致事务日志文件量。
OutstandingIOMax 此参数控制一次可在主机操作系统中按磁盘排队的数据库文件 I/O 数量。 此参数的较大值可显著帮助大型数据库应用程序的性能。
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、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,则会删除这些索引,JET_wrnCorruptIndexDeleted将从 JetAttachDatabase 返回。 应用程序需要重新创建这些索引。 如果未将 AttachDatabaseGrbit.DeleteCorruptIndexes 传递给 JetAttachDatabase,则调用将失败并JET_errSecondaryIndexCorrupted。
EventSourceKey 此参数可用于控制数据库引擎对其事件日志消息使用的事件日志。 默认情况下,所有事件日志消息都将转到应用程序事件日志。 如果配置了另一个事件日志的注册表项名称,则事件日志消息将改为转到该处。
NoInformationEvent 如果此参数为 true,则通常由数据库引擎生成的信息性事件日志消息将被抑制。
EventLoggingLevel 配置数据库引擎向事件日志发出的事件日志消息的详细信息级别。 较高的数字将导致更详细的事件日志消息。
DeleteOutOfRangeLogs 删除在软恢复期间与 (生成不匹配的日志文件) 。
CacheSizeMin 此参数配置数据库页缓存的最小大小。 大小在数据库页中。
PreferredVerPages 此参数表示相对于 MaxVerPages 的阈值,该阈值控制数据库引擎对版本页的任意使用。 如果版本存储的大小超过此阈值,则只用于可选后台任务(例如回收数据库中已删除的空间)的任何信息会牺牲为保留事务信息空间的空间。
DatabasePageSize 此参数为数据库配置页面大小。 页面大小是数据库文件可能的最大空间分配单位。 数据库页大小也非常重要,因为它设置数据库中单个记录的大小上限。

目前每个进程仅支持一个数据库页大小。 这意味着,如果你在包含使用数据库引擎的不同应用程序的单个进程中,则它们必须在数据库页面大小上达成一致。

ErrorToString 此参数可用于将JET_ERR转换为字符串。 这只能与 JetGetSystemParameter 一起使用。
RuntimeCallback 使用 JET_CALLBACK 委托配置引擎。 可能会出于以下原因调用此回调: FreeCursorLSFreeTableLSNull。 有关详细信息 ,请参阅 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 命名空间