timeSeriesLastTwoSamples
集約関数は、時系列データをタイムスタンプと値のペアとして受け取り、最新のサンプルを最大2つのみ保存します。
引数:
timestamp
- サンプルのタイムスタンプvalue
-timestamp
に対応する時系列の値 複数のタイムスタンプと値のサンプルを等しいサイズの配列として渡すことも可能です。
戻り値:
Tuple(Array(DateTime), Array(Float64))
- 長さが0から2の等しい2つの配列のペア。最初の配列にはサンプリングした時系列のタイムスタンプが含まれ、2番目の配列には対応する時系列の値が含まれます。
例: この集約関数は、グリッドに整列したタイムスタンプのために再サンプリングされた時系列データを保存するMaterialized ViewとAggregated tableとともに使用されることを意図しています。 以下の例では、原データのためのテーブルと、再サンプリングされたデータを保存するためのテーブルを考慮します。
いくつかのテストデータを挿入し、'2024-12-12 12:00:12' と '2024-12-12 12:00:30' の間のデータを読みます。
'2024-12-12 12:00:15' と '2024-12-12 12:00:30' のタイムスタンプの最後の2つのサンプルをクエリします:
集約テーブルは、各15秒ごとに整列されたタイムスタンプに対して最後の2つの値のみを保存します。これにより、原テーブルに保存されているデータよりもはるかに少ないデータを読み取ることで、PromQLのような irate
や idelta
を計算することが可能になります。
注記
この関数は実験的です。allow_experimental_ts_to_grid_aggregate_function=true
を設定することで有効にしてください。