JetDefragment 函数

适用于： Windows |Windows Server

JetDefragment 函数

JetDefragment 函数启动和停止数据库碎片整理任务，以改进数据库中的数据组织。 这样做是为了通过在数据库中更高效地使用现有磁盘分配来限制数据库增长。 它还可以通过确保数据更紧密地打包来减少工作集。 最后，它可以通过更好的数据组织来加速常见操作，从而提高应用程序性能。

数据库碎片整理是一种联机操作，不会中断常规数据库活动，例如查询操作或数据更新。 JetDefragment 也不会复制所有现有数据。 相反，它会就地对数据库进行碎片整理。 最后， JetDefragment 会恢复内部数据库空间以供重复使用，但不会向操作系统文件系统释放多余的空间。

生成的数据格式可以更高效，但通常不是最佳格式。 碎片整理仅限于释放数据库页以供重复使用，其中包含已在逻辑上删除的数据。 碎片整理还使数据库页在某些情况下可供重复使用，方法是将两个页面中的数据组合在一起，使其适合在单个页面上使用。

此操作不同于 JetCompact ，后者将只读数据库的副本转换为高度优化的形式。

    JET_ERR JET_API JetDefragment(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          JET_PCSTR szTableName,
      __out_opt     unsigned long* pcPasses,
      __out_opt     unsigned long* pcSeconds,
      __in          JET_GRBIT grbit
    );

parameters

sesid

用于此调用的会话。

dbid

要进行碎片整理的数据库。

szTableName

未使用的参数。 对给定数据库 ID 描述的整个数据库执行碎片整理。

pcPasses

启动联机碎片整理任务时，此输入参数设置碎片整理传递的最大次数。 停止联机碎片整理任务时，此输出缓冲区设置为执行的传递数。

如果此参数设置为 NULL，则联机碎片整理传递次数不受限制。

pcSeconds

启动联机碎片整理任务时，此输入参数设置碎片整理的最长时间。 停止联机碎片整理任务时，此输出缓冲区设置为用于碎片整理的时间长度。

如果此参数设置为 NULL，或者 如果 pcSeconds 指向负值，则碎片整理的最长时间不受限制。

grbit

一组指定以下选项的零个或多个位。

返回值

此函数返回具有以下返回代码之一 的JET_ERR 数据类型。 有关可能的 ESE 错误的详细信息，请参阅 可扩展存储引擎错误 和 错误处理参数。

成功后，将执行请求的操作，即使用给定选项启动给定数据的碎片整理任务，或执行停止现有碎片整理任务的操作。

失败时，未完成请求的启动或停止联机碎片整理作业的操作。 没有其他副作用发生。

备注

联机碎片整理由参数设置以及此 API 控制。 默认系统参数值为 JET_OnlineDefragAll，这意味着为所有支持的数据结构启用碎片整理。 但是，使用 JetSetSystemParameter，可以禁用联机碎片整理，或选择性地仅为数据库空间树、仅数据库、仅流文件或这些选项的任意组合启用它。 如果联机碎片整理的系统设置设置为过时设置， JetDefragment 会将该设置视为JET_OnlineDefragAll。

每个数据库最多可以运行一个任务。 任务在托管 ESE 的进程中作为线程运行。

在碎片整理任务继续期间，用于启动联机碎片整理任务的会话随后可用于数据库操作，因为碎片整理任务分配了自己的会话。 给定的会话仅用于检查与任务启动会话关联的权限，实际上不用于碎片整理操作本身。

要求

另请参阅

JET_ERR
JET_SESID
JetCompact
JetDefragment2
JetSetSystemParameter
JetStopService