timeSeriesPresentToGrid

一定間隔のグリッドの各時点に、時系列のサンプルが存在するかどうかを返します。

​

timeSeriesPresentToGrid

導入バージョン: v26.9.0

指定したグリッド上に時系列データが存在するかどうかを判定する集約関数です。グリッド上の各点について、指定した時間ウィンドウ内にサンプルが1つ以上存在する場合は1を、存在しない場合はNULLを返します。

この関数はプライベートプレビュー段階です。有効にするには enable_time_series_aggregate_functions=true を設定してください。

構文

timeSeriesPresentToGrid(start_timestamp, end_timestamp, grid_step, staleness)(timestamp, value)
timeSeriesPresentToGrid(start_timestamp, end_timestamp, grid_step, staleness)(samples)

パラメータ

• 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 — 対象とするサンプルの最大 “staleness” を秒単位で指定します。staleness ウィンドウは左開・右閉区間です。小数、または数値や ’15s’、‘1m’ のような期間を含む文字列で指定することもできます。UInt32 または Float* または Decimal* または String

引数

• timestamp — サンプルのタイムスタンプ。単一の値または配列を指定できます。UInt32 または DateTime または DateTime64 または Array(UInt32) または Array(DateTime) または Array(DateTime64)
• value — タイムスタンプに対応する時系列の値。単一の値または配列を指定できます。Float* または Array(Float*)
• samples — (timestamp, value) のタプルの配列として渡す時系列のサンプル。タプルの各要素は、上記のタイムスタンプ型および値型を持ちます。タイムスタンプと値を 2 つの引数に分けて渡す代わりに使用できます。Array(Tuple(T1, T2))

戻り値

ウィンドウ内にサンプルが 1 つ以上存在するグリッドポイントには 1 を返し、それ以外には NULL を返します。Array(Nullable(UInt8))

例