Skip to main content

timeSeriesSumToGrid

引入版本:v26.9.0 聚合函数,接收由时间戳和值组成的时间序列数据,并在由起始时间戳、结束时间戳和步长定义的等间隔的时间网格上,计算类 PromQL 的 sum_over_time。对于网格上的每个点,会在指定的时间窗口内选取样本来计算总和。 样本可以通过以下三种形式之一传入:
  • 作为两个参数 timestamp 和 value 传入,每行包含一个样本;
  • 作为时间戳数组和值数组传入,每行包含一个完整的时间序列;
  • 作为由 (timestamp, value) Tuple 组成的单个数组传入,每行包含一个完整的时间序列。
如果多个样本的时间戳相同,则只使用其中值最大的那个样本。非数字 (NaN) 值的优先级低于任何其他值,因此只有当该时间戳上的所有样本均为 NaN 时,才会使用 NaN 值。
此函数目前处于私有预览阶段,可通过设置 enable_time_series_aggregate_functions=true 启用。
语法
参数
  • start_timestamp — 指定网格的起始点。也可以是小数,或包含数字或日期时间文本的字符串。UInt32 或 DateTime 或 DateTime64 或 Float* 或 Decimal* 或 String
  • end_timestamp — 指定网格的结束点。也可以是小数,或包含数字或日期时间文本的字符串。UInt32 或 DateTime 或 DateTime64 或 Float* 或 Decimal* 或 String
  • grid_step — 指定网格的步长 (以秒为单位) 。也可以是小数,或包含数字或时长 (如 ’15s’ 或 ‘1m’) 的字符串。UInt32 或 Float* 或 Decimal* 或 String
  • staleness — 指定参与计算的样本的最大过期时长 (以秒为单位) 。过期窗口为左开右闭区间。也可以是小数,或包含数字或时长 (如 ’15s’ 或 ‘1m’) 的字符串。UInt32 或 Float* 或 Decimal* 或 String
参数 返回值 返回指定网格上各值之和。返回的数组中,每个时间网格点对应一个值。如果某个网格点的窗口内没有样本,则对应值为 NULL。Array(Nullable(Float64)) 示例 基本用法:使用单个时间戳-值对
Query
Response
使用 array 参数
Query
Response
最后修改于 2026年10月14日