数据库参数

  • 项目

适用于： Windows |Windows Server

数据库参数

本主题包含用于数据库的参数。

JET_paramCheckFormatWhenOpenFail
44

如果设置此参数，则当打开以前版本的数据库引擎中的数据库或事务日志时， 将导致 JetInit 返回特殊错误。 这些错误包括：

错误

说明

JET_errDatabase200Format

数据库和/或事务日志文件是在 Windows NT 3.51 中使用数据库引擎创建的。

JET_errDatabase400Format

数据库和/或事务日志文件是在 Windows NT Server 4.0 之前的测试版本中使用数据库引擎创建的。

JET_errDatabase500Format

数据库和/或事务日志文件是使用 Windows NT Server 4.0 中的数据库引擎创建的。

Windows Vista： 对于 Windows Vista 及更高版本，此参数已过时，不会影响数据库引擎的操作。

Label 值

默认值：

True

键入：

布尔

有效范围：

False、True

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

否

影响可靠性：

否

影响性能：

否

影响资源：

否

可用性：

全部

JET_paramDatabasePageSize
64

此参数配置数据库的页大小。 页面大小是数据库文件可能分配的最小空间单位。 数据库页大小也非常重要，因为它设置了数据库中单个记录的大小上限。

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

Label 值

默认值：

4096

键入：

整数

有效范围：

2048, 4096, 8192

范围：

全球

在 JetCreateInstance 之后设置：

否

在 JetInit 之后设置：

否

影响物理布局：

是

影响可靠性：

否

影响性能：

是

影响资源：

是

可用性：

全部

JET_paramDbExtensionSize
18

此参数控制每次需要增大以容纳更多数据时添加到数据库文件的空间量。 大小以数据库页为单位。

Label 值

默认值：

256

键入：

整数

有效范围：

1 – 2147483647

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

Windows Vista： 对于 Windows Vista 及更高版本：是

影响物理布局：

否

影响可靠性：

否

影响性能：

是

影响资源：

是

可用性：

全部

JET_paramEnableIndexChecking
45

如果此参数为 true，则会在 JetAttachDatabase 时间检查每个数据库是否针对使用操作系统中较旧版本的 NLS 库生成的 Unicode 键列的索引。 必须执行此操作，因为数据库引擎会保留 LCMapStringW 生成的排序键，并且这些排序键的值会从发布更改为发布。

如果检测到主索引处于此状态，则 JetAttachDatabase 将始终失败并JET_errPrimaryIndexCorrupted。

如果检测到任何辅助索引处于此状态，则有两种可能的结果。 如果JET_bitDbDeleteCorruptIndexes传递到 JetAttachDatabase ，则将删除这些索引，并从 JetAttachDatabase 返回JET_wrnCorruptIndexDeleted。 应用程序需要重新创建这些索引。 如果JET_bitDbDeleteCorruptIndexes未传递到 JetAttachDatabase ，则调用将失败并JET_errSecondaryIndexCorrupted。

注意 强烈建议应用程序将此参数设置为 True。

注意 强烈建议应用程序避免在其主键中使用 Unicode 键列 (聚集) 索引。

Label 值

默认值：

错误

键入：

布尔

有效范围：

False、True

范围：

全球

Windows Vista： 对于 Windows Vista 及更高版本：实例

在 JetCreateInstance 之后设置：

否

在 JetInit 之后设置：

否

影响物理布局：

否

影响可靠性：

是

影响性能：

否

影响资源：

否

可用性：

全部

JET_paramEnableIndexCleanup
54

当此参数设置为 true 时，数据库引擎可能会根据需要在 JetInit 时间自动清理 Unicode 键列上的索引，以避免由于 Windows 中的 NLS 库更改而导致的数据库格式更改。 此类更改将定期对 NLS 库进行，以添加新语言的支持、向语言添加缺少的字符、向语言添加排序规则顺序或修复语言排序规则顺序中的 bug。 这些更改会影响 LCMapStringW 生成的排序键，这些键由数据库引擎保留为索引键的组件。

请务必认识到，对索引的更改可能会如此之大，以至于无法进行增量清理。 在这种情况下，将按照 JET_paramEnableIndexChecking 的规定处理索引。

注意 强烈建议应用程序将此参数和 JET_paramEnableIndexChecking 设置为 True 。

Label 值

默认值：

True

键入：

布尔

有效范围：

False、True

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

Windows Vista： 对于 Windows Vista 及更高版本：是

影响物理布局：

否

影响可靠性：

否

影响性能：

否

影响资源：

否

可用性：

Windows Server 2003 及更高版本

JET_paramOneDatabasePerSession
102

如果此参数为 true，则给定会话一次只允许使用 JetOpenDatabase 打开一个数据库。 临时数据库已从此限制中排除。

Windows XP 和 Windows Server 2003： 此参数仅在 Windows XP 和 Windows Server 2003 上写入。

Windows Vista： 自 Windows Vista 起，此参数的行为正常。

注意 此参数为仅写入。

Label 值

默认值：

错误

键入：

布尔

有效范围：

False、True

范围：

全球

在 JetCreateInstance 之后设置：

否

Windows Vista： 对于 Windows Vista 及更高版本：是

在 JetInit 之后设置：

否

影响物理布局：

否

影响可靠性：

否

影响性能：

否

影响资源：

否

可用性：

Windows XP 及更高版本

JET_paramEnableOnlineDefrag
35

此参数控制使用 JetDefragment 启动时联机碎片整理的行为。 有关详细信息，请参阅 JetDefragment 。

Windows 2000：在 Windows 2000 上，此参数是一个简单的布尔值，当 由 JetDefragment 启动时，它将限制联机碎片整理。 设置为 TRUE 时，将对数据库中每个表的记录执行联机碎片整理。

Windowsxp： 在 Windows XP 及更高版本中，可以将此参数设置为以下一个或多个选项：

选项

说明

JET_OnlineDefragDisable

不要执行联机碎片整理。 这是二进制文件，等效于此参数的 Windows 2000 设置为 False。

JET_OnlineDefragAllOBSOLETE

执行完整的联机碎片整理。 这是二进制等效于此参数的 Windows 2000 设置 True。

JET_OnlineDefragDatabases

对数据库中每个表的记录执行联机碎片整理。

JET_OnlineDefragSpaceTrees

对数据库中每个表的空间树执行联机碎片整理。

JET_OnlineDefragStreamingFiles

此参数用于支持 Microsoft Exchange 基础结构，不应在应用程序中使用。

JET_OnlineDefragAll

执行完整的联机碎片整理。 这在概念上等效于此参数的 Windows 2000 设置 True。
Label 值

默认值：

Windows 2000： 真

Windows XP：对于 Windows XP 及更高版本： JET_OnlineDefragAll

键入：

Windows 2000： 布尔

Windows XP 及更高版本： JET_GRBIT (整数)

有效范围：

Windows 2000： False、True

Windows XP 及更高版本： 0 – JET_OnlineDefragAll

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

是

影响物理布局：

否

影响可靠性：

是

影响性能：

是

影响资源：

否

可用性：

全部

JET_paramPageFragment
20

此参数是数据库引擎用于控制可用空间碎片的阈值。 大小以数据库页为单位。

Label 值

默认值：

8

键入：

整数

有效范围：

0 – 2147483647

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

否

影响可靠性：

否

影响性能：

是

影响资源：

是

可用性：

全部

JET_paramRecordUpgradeDirtyLevel
78

此参数控制数据库页缓存管理器写入已就地格式转换的数据库页的积极程度。 从使用 Windows 2000 数据库引擎创建但由 Windows XP 或更高版本的数据库引擎使用的数据库加载页面时，会动态进行这些格式转换。

Label 值

默认值：

1

键入：

整数

有效范围：

0-3

范围：

全球

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

是

影响物理布局：

是

影响可靠性：

否

影响性能：

是

影响资源：

否

可用性：

Windows XP 和更高版本

JET_paramWaypointLatency
153

日志中的延迟 () 提示/最高提交日志之后，以延迟数据库页刷新。 启用此延迟可以在发生最近日志文件灾难性丢失的情况下恢复数据库。 请参阅 JET_bitReplayIgnoreLostLogs。

Label 值

默认值：

0

键入：

整数

有效范围：

0-1023

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

否

影响可靠性：

是

影响性能：

是

影响资源：

否

可用性：

Windows 7

JET_paramDefragmentSequentialBTrees
160

打开/关闭自动顺序 B 树碎片整理。

Label 值

默认值：

1

键入：

布尔

有效范围：

0-1

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

是

影响可靠性：

否

影响性能：

是

影响资源：

否

可用性：

Windows 7

JET_paramDefragmentSequentialBTreesDensityCheckFrequency
161

确定检查 B 树密度的频率。

Label 值

默认值：

10

键入：

整数

有效范围：

0-最大整数

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

是

影响可靠性：

否

影响性能：

是

影响资源：

否

可用性：

Windows 7

JET_paramIOThrottlingTimeQuanta
162

I/O 限制机制为运行任务提供的最大时间（以毫秒为单位），使其被视为“已完成”。

Label 值

默认值：

125

键入：

整数

有效范围：

0-10000

范围：

全球

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

否

影响可靠性：

否

影响性能：

是

影响资源：

否

可用性：

Windows 7

要求

要求 值

客户端

需要 Windows Vista、Windows XP 或 Windows 2000 Professional。

服务器

需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。

标头

在 Esent.h 中声明。

另请参阅

JetAttachDatabase
JetCreateInstance
JetDefragment
JetInit