常用构建基块 > 数据库连接构建基块 > 记录历史数据 > 清除历史数据数据库表
清除历史数据数据库表
历史数据数据库表可手动清除，也可通过历史数据清除计划程序 (PTC.DBConnection.HistoricalDataPurgeScheduler) 排程。清除历史数据数据库表时，仅删除历史数据，并不会不删除任何其他数据库表中的相关数据。
清除历史数据服务
PurgeHistoricalData 服务位于历史数据管理事物形态 (PTC.DBConnection.HistoricalDataManagementThingShape) 上，因此，可通过历史数据管理器 (PTC.DBConnection.HistoricalDataManager) 来执行。此服务的输入参数 DataAgeInDays 表示数据在历史数据数据库表中保存的时间。例如，如果用户指定的值为 14，则将删除历史数据数据库表中存储时间超过 14 天的所有条目。PurgeHistoricalData 服务由历史数据清除计划程序按照该计划程序指定的频率进行调用。虽然可使用此服务手动清除数据，但最好还是使用计划程序。
历史数据清除计划程序
历史数据清除计划程序 (PTC.DBConnection.HistoricalDataPurgeScheduler) 使用 ThingWorx Scheduler 事物模板。历史数据清除计划程序会调用 PTC.DBConnection.HistoricalDataManager 事物的 PurgeHistoricalData 服务。
要使用历史数据清除计划程序，必须配置以下三个事物：“属性和警报”下的 DataAgeInDays 属性、以及“常规信息”下的“日程表”和“启动时自动启用计时器”。
• 历史数据清除计划程序上的 DataAgeInDays 属性用于确定数据库表中的数据在数据库中保存多长时间后才会被清除。例如，如果值为 28，则表示将根据配置表的“日程表”属性中指定的频率清除数据库中存储时间超过 4 周 (28 天) 的所有数据。默认情况下，DataAgeInDays 的值为 14。
• “日程表”字段采用 cron 作业表达式，用于处理从历史数据数据库表中清除数据的频率。默认表达式 (如上所示) 为每天 (午夜) 执行一次数据清除的表达式。有关构建相应 cron 表达式的详细信息，请参阅以下 ThingWorx 支持文章：Thingworx: How To Format a Cron String。许多免费网站也可基于所需输入生成 cron 表达式。
• “启动时自动启用计时器”复选框可确定计划程序是否处于活动状态。如未选中“启动时自动启用计时器”复选框，即使历史数据数据库表中的数据符合清除条件，也不会被清除。默认情况下，计划程序未被启用。要启用计划程序，请从计划程序的“服务”页面执行 EnableScheduler 服务。无论计划程序是已启用还是已禁用，计划程序的状况都会通过“属性和警报”页面上的 Enabled 属性来显示。
这对您有帮助吗?