NullCleanup 函数

NullCleanup 函数释放时间系列实例中某个范围内或整个时间系列实例内仅包含空元素的所有页面。

语法

NullCleanup(ts          TimeSeries, 
       begin_stamp datetime year to fraction(5), 
       end_stamp   datetime year to fraction(5),
       flags       integer default 0) 
returns TimeSeries;

NullCleanup(ts          TimeSeries,
       flags       integer default 0) 
returns TimeSeries;

NullCleanup(ts          TimeSeries, 
       begin_stamp datetime year to fraction(5)
       flags       integer default 0) 
returns TimeSeries;

NullCleanup(ts          TimeSeries, 
       NULL,
       end_stamp   datetime year to fraction(5),
       flags       integer default 0) 
returns TimeSeries;

ts: 要对其执行操作的时间系列。
begin_stamp: 范围的起始点。
end_stamp: 范围的结束点。
flags: flags 参数值中描述了 flags 参数的有效值。缺省值为 0。

描述

使用 NullCleanup 函数可释放时间系列实例中以下某个时间范围内的空页面：

指定的起始点和指定的结束点
整个时间系列实例
时间系列实例中指定的起始点和结束点
时间系列实例的起始点和指定的结束点

如果范围的起始点早于时间系列实例的原点，那么将出现错误。

返回结果

释放了范围中所有空页面的时间系列。

示例

示例 1：释放指定的起始点和结束点之间的空页面

以下示例释放位置标识为 4727354321000111 的时间系列实例中指定日期的一天范围内的空页面：

UPDATE ts_data
SET meter_data = NullCleanup(meter_data,
        '2010-11-11 00:00:00.00000'
     ::datetime year to fraction(5),
        '2010-11-11 00:00:00.00000'
     ::datetime year to fraction(5))
WHERE loc_esi_id = 4727354321000111;

示例 2：释放时间系列实例中的所有空页面

以下示例释放位置标识为 4727354321000111 的时间系列实例中的所有空页面：

UPDATE ts_data
SET meter_data = NullCleanup(meter_data)
WHERE loc_esi_id = 4727354321000111;

示例 3：释放从时间系列实例的起始点到指定日期之间的空页面

以下示例释放位置标识为 4727354321000111 的时间系列实例中从该时间系列实例的起始点到指定结束点之间的空页面：

UPDATE ts_data
SET meter_data = NullCleanup(meter_data, NULL,
        '2010-11-11 00:00:00.00000'
     ::datetime year to fraction(5))
WHERE loc_esi_id = 4727354321000111;