事务日志参数

  • 项目

适用于： Windows |Windows Server

本文内容
事务日志参数
要求
另请参阅

事务日志参数

本主题包含用于事务日志的参数。

JET_paramBaseName
3

此参数设置用于数据库引擎使用的许多文件的三个字母前缀。 例如，检查点文件称为 EDB。默认情况下，CHK，因为 EDB 是默认基名称。 基名称可用于轻松区分属于不同实例或不同应用程序的文件集。

Label 值

默认值：

“edb”

键入：

字符串

有效范围：

3 个字符

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

是

影响可靠性：

否

影响性能：

否

影响资源：

否

可用性：

All

JET_paramCircularLog
17

此参数配置数据库引擎管理事务日志文件的方式。

关闭循环日志记录时，生成的所有事务日志文件将保留在磁盘上，直到不再需要这些文件，因为已执行数据库的完整备份。 在此模式下，可以从旧备份还原并向前播放所有保留的事务日志文件，以便不会因强制还原的灾难而丢失数据。 需要定期完整备份以防止磁盘填满事务日志文件。

启用循环日志记录时，磁盘上仅保留小于当前检查点的事务日志文件。 此模式的好处是无需备份即可停用旧的事务日志文件。 缺点是，不再可能还原零数据丢失。

Label 值

默认值：

False

键入：

布尔

有效范围：

False、True

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

是

影响可靠性：

是

影响性能：

否

影响资源：

是

可用性：

All

JET_paramCommitDefault
16

此参数控制在会话上提交最外层事务时采取的默认操作。 任何可以传递给 JetCommitTransaction 的有效选项也可以设置为实例中的所有会话和/或特定会话的默认选项。 有关这些选项的更多详细信息 ，请参阅 JetCommitTransaction 。

此参数会影响事务的可靠性和性能。 有关更多详细信息 ，请参阅 JetCommitTransaction 。

Label 值

默认值：

0

键入：

JET_GRBIT (整数)

有效范围：

JetCommitTransaction 的有效选项

范围：

实例或会话

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

是

影响物理布局：

否

影响可靠性：

是

影响性能：

是

影响资源：

否

可用性：

All

JET_paramDeleteOldLogs
48

如果此参数为 true，并且日志文件路径 (JET_paramLogFilePath) 指向 的事务日志文件都是已过时的版本，则会自动删除这些事务日志文件。

Windows 2000：将数据库从 Windows NT 升级到 Windows 2000 时，必须使用此参数。 如果数据库不处于一致状态，并且删除了旧的日志文件，则数据库的内容将丢失。

Label 值

默认值：

Windows 2000： 假

Windowsxp： 真

键入：

布尔

有效范围：

False、True

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

是

影响可靠性：

是

影响性能：

否

影响资源：

否

可用性：

All

JET_paramIgnoreLogVersion
47

如果此参数为 true，则数据库引擎不会在 JetInit 期间验证事务日志文件版本号。

Windowsxp： 从 Windows XP 起，此参数已过时，不会影响数据库引擎的操作。

Label 值

默认值：

False

键入：

布尔

有效范围：

False、True

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

否

影响可靠性：

是

影响性能：

否

影响资源：

否

可用性：

All

JET_paramLegacyFileNames
136

此参数提供与早期版本数据库引擎的文件命名约定的向后兼容性。

当前支持以下选项：

JET_bitESE98FileNames

如果存在此选项，则数据库引擎将对其文件使用以下命名约定：

  • 事务日志文件将使用 。其文件扩展名的 LOG

  • 检查点文件将使用 。其文件扩展名的 CHK

Label 值

默认值：

JET_bitESE98FileNames

键入：

JET_GRBIT (整数)

有效范围：

0、JET_bitESE98FileNames

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

是

影响可靠性：

否

影响性能：

否

影响资源：

否

可用性：

Windows Vista 及更高版本

JET_paramLogBuffers
12

此参数将配置在将日志记录写入事务日志文件之前用于缓存日志记录的内存量。 此参数的单位是保存事务日志文件的卷的扇区大小。 扇区大小几乎始终为 512 字节，因此可以安全地假设单元的大小。

此参数对性能有影响。 当数据库引擎处于繁重的更新负载下时，此缓冲区可能会非常快地充满。 在如此高的负载条件下，事务日志文件更大的缓存大小对于良好的更新性能至关重要。 对于这种情况，默认值已知太小。

Windows XP 和 Windows 2000： 在 Windows XP 和早期版本中，不建议将此参数设置为多个缓冲区，这些缓冲区的字节数 (大于事务日志文件大小的一半) 。

Label 值

默认值：

Windows 2000、Windows XP 和 Windows Server 2003： 80

Windows Vista： 126

键入：

整数

有效范围：

Windows 2000、Windows XP 和 Windows Server 2003： 80 – 2147483647

Windows Vista： 1 – 2147483647

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

否

影响可靠性：

否

影响性能：

是

影响资源：

是

可用性：

All

JET_paramLogCheckpointPeriod
14

此参数将数据库引擎配置为在生成指定数量的日志文件扇区时采用检查点。

Windowsxp： 从 Windows XP 起，此参数已过时，不会影响数据库引擎的操作。

Label 值

默认值：

1024

键入：

整数

有效范围：

0 – 2147483647

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

否

影响可靠性：

是

影响性能：

是

影响资源：

否

可用性：

All

JET_paramLogFileCreateAsynch
69

当此参数设置为 true 时，数据库引擎将在使用当前事务日志文件时创建下一个事务日志文件。 目的是最大程度地减少在更新负载过大的情况下从一个事务日志文件切换到下一个事务日志文件所花费的时间。

Label 值

默认值：

True

键入：

布尔

有效范围：

False、True

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

是

影响可靠性：

否

影响性能：

是

影响资源：

是

可用性：

Windows XP 和更高版本

JET_paramLogFilePath
2

此参数指示将包含实例事务日志的文件夹的相对或绝对文件系统路径。 路径必须以反斜杠字符结尾，该字符指示目标路径是文件夹。 事务日志文件包含在崩溃后使数据库文件处于一致状态所需的信息。 它们通常命名为 EDB*。日志。 事务日志文件的内容与数据库文件本身一样重要， (如果不是比数据库文件本身更) 的话。 应尽一切努力保护它们。

还将有名为 RES1 的其他保留日志文件。LOG 和 RES2。与普通日志文件一起存储的 LOG。 这些文件的内容并不重要，因为它们的唯一用途是保留磁盘空间，以允许引擎在磁盘不足的情况下正常关闭。 这些日志也是一个临时日志文件，通常名为 EDBTMP。记录在此同一文件夹中。 此文件的内容也不重要。 此文件是准备使用的新日志文件。

事务日志文件的主机卷的属性及其相对于数据库引擎使用的其他文件的位置可能会极大地影响性能。

注意 如果指定了相对路径，则它将相对于托管使用数据库引擎的应用程序的进程当前工作目录。

Label 值

默认值：

"."

键入：

文件夹路径 (字符串)

有效范围：

0 – 246 个字符

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

是

影响可靠性：

是

影响性能：

是

影响资源：

否

可用性：

All

JET_paramLogFileSize
11

此参数将配置事务日志文件的大小。 每个事务日志文件的大小都是固定的。 大小等于此系统参数的设置（以 1024 字节为单位）。

此参数会影响可靠性。 如果设置太小，则会更快地达到 (1048575) 的最大日志文件数。 发生这种情况时，必须完全关闭实例，必须删除现有的日志文件，并且必须重启实例。 此操作不仅会降低应用程序的可用性，还会使应用程序数据库的任何以前备份失效。

此参数对性能有影响。 如果设置非常大， JetInit 的速度会很慢，因为数据库引擎必须在初始化时以最低) 读取最年轻的日志文件 (。 如果设置非常大，则还需要更长的时间才能在日志文件之间切换。 如果设置非常小，则需要为给定数量的更新创建更多的日志文件，这将增加更多的开销。

Label 值

默认值：

5120

键入：

整数

有效范围：

Windows 2000、Windows XP 和 Windows Server 2003： 128 – 32768

Windows Vista： 64 – 32768

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

是

影响可靠性：

是

影响性能：

是

影响资源：

是

可用性：

All

JET_paramLogWaitingUserMax
15

此参数尝试优化由持久提交导致的日志缓冲区刷新，方法是在强制刷新之前等待指定数量的会话等待持久提交，希望另一个事务将共享刷新。

Windowsxp： 从 Windows XP 起，此参数已过时，不会影响数据库引擎的操作。

Label 值

默认值：

3

键入：

整数

有效范围：

0 – 2147483647

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

否

影响可靠性：

否

影响性能：

是

影响资源：

否

可用性：

All

JET_paramRecovery
34

此参数是控制实例故障恢复的主开关。 如果此参数设置为“开”，则 ARIES 样式恢复将用于在进程或计算机崩溃时使实例中的所有数据库处于一致状态。 如果此参数设置为“关闭”，则实例中的所有数据库都将在无故障恢复的情况下进行管理。 也就是说，如果在进程退出或计算机关闭之前未使用 JetTerm 完全关闭实例，则该实例中所有数据库的内容都将损坏。

在已知数据库内容在发生崩溃时没有用的特殊情况下，禁用恢复非常有用。 应为所有其他情况启用恢复。

Label 值

默认值：

"On"

键入：

字符串

有效范围：

0 – 259 个字符

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

是

影响可靠性：

是

影响性能：

是

影响资源：

是

可用性：

All

JET_paramSystemPath
0

此参数指示将包含实例的检查点文件的文件夹的相对或绝对文件系统路径。 路径必须以反斜杠字符结尾，该字符指示目标路径是文件夹。 检查点文件是每个实例维护的简单文件，用于记住必须重播的最早事务日志文件，使该实例中的所有数据库在崩溃后处于一致状态。 检查点文件通常名为 EDB。CHK。

注意 如果指定了相对路径，则它将相对于托管使用数据库引擎的应用程序的进程当前工作目录。

Label 值

默认值：

"."

键入：

文件夹路径 (字符串)

有效范围：

0 – 246 个字符

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

是

影响可靠性：

否

影响性能：

否

影响资源：

否

可用性：

All

JET_paramWaitLogFlush
13

此参数尝试优化由持久提交引起的日志缓冲区的刷新，方法是在强制刷新之前等待指定的时间段，希望另一个事务将共享刷新。

Windowsxp： 从 Windows XP 起，此参数已过时，不会影响数据库引擎的操作。

Label 值

默认值：

0

键入：

整数

有效范围：

0 – 2147483647

范围：

实例或会话

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

是

影响物理布局：

否

影响可靠性：

否

影响性能：

是

影响资源：

否

可用性：

All

JET_paramLegacyFileNames
136

此参数用于指定要与 Windows Server 2003 和以前的文件命名方案一起维护的文件命名兼容性功能。 有关不同文件及其命名的详细信息，请参阅 可扩展存储引擎文件。

JET_bitESE98FileNames可确保事务日志文件和检查点文件上使用的文件扩展名与 Windows Server 2003 中使用的文件扩展名相同。 请注意，如果从 Windows Server 2003 升级，则仍不需要指定此位，因为如果JET_paramCircularLog设置为 true，引擎将自动升级文件扩展名;如果JET_paramCircularLog为 false，则保留较旧的日志扩展。

注意 若要设置位，应首先检索值，然后在所需的兼容性位中检索“或”。

Label 值

默认值：

JET_bitESE98FileNames

键入：

JET_GRBIT (整数)

有效范围：

JET_bitESE98FileNames

范围：

实例

在 JetCreateInstance 之后设置：

是

在 JetInit 之后设置：

否

影响物理布局：

是

影响可靠性：

否

影响性能：

否

影响资源：

否

可用性：

从 Windows Server 2008 和 Windows Vista 开始

要求

要求 值

客户端

需要 Windows Vista、Windows XP 或 Windows 2000 专业版。

服务器

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

标头

在 Esent.h 中声明。

另请参阅

可扩展存储引擎文件
JetCommitTransaction
JetCreateInstance
JetInit
JetTerm