timeSeriesGroupArray

タイムスタンプ順に時系列データを昇順で並べ替えます。

構文

timeSeriesGroupArray(timestamp, value)

引数

timestamp - サンプルのタイムスタンプ
value - timestamp に対応する時系列の値

戻り値

この関数は、timestamp を昇順にソートしたタプル (timestamp, value) の配列を返します。同じ timestamp に複数の値がある場合、関数はそれらの中で最大の値を選択します。

例

WITH
    [110, 120, 130, 140, 140, 100]::Array(UInt32) AS timestamps,
    [1, 6, 8, 17, 19, 5]::Array(Float32) AS values -- 上記のタイムスタンプに対応する値の配列
SELECT timeSeriesGroupArray(timestamp, value)
FROM
(
    -- このサブクエリは、タイムスタンプと値の配列を `timestamp`、`value` の行形式に変換します
    SELECT
        arrayJoin(arrayZip(timestamps, values)) AS ts_and_val,
        ts_and_val.1 AS timestamp,
        ts_and_val.2 AS value
);

レスポンス:

   ┌─timeSeriesGroupArray(timestamp, value)───────┐
1. │ [(100,5),(110,1),(120,6),(130,8),(140,19)]   │
   └──────────────────────────────────────────────┘

複数のタイムスタンプと値のサンプルを、同じ長さの配列として渡すこともできます。配列引数を用いた同じクエリは次のとおりです：

WITH
    [110, 120, 130, 140, 140, 100]::Array(UInt32) AS timestamps,
    [1, 6, 8, 17, 19, 5]::Array(Float32) AS values -- 上記のタイムスタンプに対応する値の配列
SELECT timeSeriesGroupArray(timestamps, values);

注記

この関数は実験的機能です。allow_experimental_ts_to_grid_aggregate_function=true を設定して有効にしてください。