時系列データのクエリ

時系列データはポイントという単位で時系列データベースに記録されています。ポイントは IoT センサデータやログデータ、工場設備や産業機械の計測機器が上げる計測値など様々です。

ポイントから時系列データを取得するとき、以下のようなクエリをリクエストできます。

例：クエリのサンプル

期間データ

期間は開始時刻以上、終了時刻未満で指定できます。例えば期間1 日のデータを取得する場合は当日 00:00 以上～翌日 00:00 未満を指定します。

指定範囲の期間データに対する検索方法は以下のとおりです。

検索方法	内容
全て（生値）	指定範囲の期間データの全レコードを返す。何も加工していないローデータ。
最新値	指定範囲の期間データの最も新しいレコードを 1 件だけ返す。
最古値	指定範囲の期間データの最も古いレコードを 1 件だけ返す。

期間データを任意の時間単位で集計できます。例えば5 分、30 分、1 時間、7 日など任意の時間単位を指定できます。

集計クエリは、期間を時間単位で区切った集計区間毎に 1 件ずつレコードを返します。例えば期間を1 日 (当日 00:00 以上～翌日 00:00 未満)、集計時間を1 時間にしたクエリをリクエストすると、レスポンスには24 件のデータが含まれます。

集計方法は以下のとおりです。

集計区間に含まれる集計前のローデータのレコード件数を取得できます。

集計結果のタイムスタンプは集計区間ごとの時刻になります。例えば期間を1 日 (当日 00:00 以上～翌日 00:00 未満)、集計時間を1 時間にしたクエリをリクエストすると、タイムスタンプは00:00、01:00、02:00…22:00、23:00になります。

これを応用して時刻の揃っていないポイントのグループに対し、集計クエリを使うことでタイムスタンプを揃えることができます。

数値の大小比較や文字列比較でフィルタします。以下の条件指定が可能です。

条件	内容
以上	任意の閾値とレコードの数値を比較して閾値以上なら返す。
以下	任意の閾値とレコードの数値を比較して閾値以下なら返す。
より大きい	任意の閾値とレコードの数値を比較して閾値より大きければ返す。
未満	任意の閾値とレコードの数値を比較して閾値未満なら返す。
数値一致	任意の閾値とレコードの数値を比較して一致すれば返す。
文字列一致	任意の閾値とレコードの文字列を比較して一致すれば返す。

RealBoard では最大 2 つの閾値と条件を組み合わせて指定できます。組み合わせは、すべての条件を満たしたとき成立する AND 条件です。

時系列データの値が変化したときのレコードを検出して返します。同じ値が連続している時間帯がある場合、その時間帯のレコードをレスポンスに含めないようフィルタする機能です。

フィルタクエリと集計クエリを組み合わせた場合、ローデータに対してフィルタ処理が適用された後に集計処理が実行されます。