クエリ（SQL）

蓄積した計測値を任意の SQL で集計し、表示・CSV 出力・グラフ化する

サイドバーの 「データ活用」→「クエリ」 では、蓄積した計測値に対して任意の SQLを実行し、結果を表で確認したり CSV に書き出したりできます。定型画面では作れない集計や、月次報告用のデータ抽出に使います。

クエリを実行する

「CSV出力」 をクリックすると、現在の SQL の実行結果を CSV ファイルとしてダウンロードします。

使えるテーブル

エディタ横のテーブル定義パネルにも表示されます。metrics が計測値の本体、events が AI アプリのイベント、dim_* が名前を引くためのテーブルです。

metrics — 計測値（1 行 = 1 計測）

events — AI アプリのイベント（1 行 = 1 回の発生）

detail の中身は detail->>'ruleName' のように取り出します。30 日間残ります。

-- 直近 7 日、ルールごと・日ごとに「いる」になった回数
select date_trunc('day', ts) as day, detail->>'ruleName' as rule, count(*) as times
from events
where event_type = 'presenceStart' and ts > now() - interval '7 days'
group by 1, 2
order by 1, 2;

dim_device — デバイス

device_id / tenant_id / edge_pc_id / name（デバイス名）/ type / sensor_kind / deleted_at

削除したデバイスも、計測値が残っているあいだは行が残ります（deleted_at に削除日時が入ります）。デバイスを消した直後でも、その計測値を名前つきで集計・CSV 出力できます。現役のデバイスだけを見たいときは where d.deleted_at is null を足してください。

dim_edge_pc — エッジPC

edge_pc_id / tenant_id / name（エッジPC名）/ deleted_at

dim_metric — 指標定義

metric_key / display_name（表示名）/ unit（単位）/ value_type

SQL の例

センサ別の直近 1 時間の平均

select d.name as device, m.metric_key, count(*), round(avg(m.value)::numeric, 2) as avg
from metrics m
join dim_device d using (device_id)
where m.ts > now() - interval '1 hour'
group by 1, 2
order by 1, 2

エッジPC別・1 時間ごとの推移

select date_trunc('hour', m.ts) as hour,
       e.name as site,
       round(avg(m.value)::numeric, 2) as avg_value
from metrics m
join dim_edge_pc e using (edge_pc_id)
where m.metric_key = 'weight'
  and m.ts > now() - interval '3 days'
group by 1, 2
order by 1, 2

単位付きで最新値を並べる

select distinct on (m.device_id)
       d.name as device, mt.display_name as metric,
       m.value, mt.unit, m.ts
from metrics m
join dim_device d using (device_id)
join dim_metric mt using (metric_key)
order by m.device_id, m.ts desc

結果をグラフにする

実行結果の上にある 「グラフ設定」 で、結果の列をグラフの軸に割り当てられます。

設定するとその場でプレビューされ、クエリと一緒に保存されます。保存したグラフ設定は、ダッシュボードの SQL結果グラフ ウィジェットで使われます。→ ダッシュボード

制限とセキュリティ

その他の上限値は制限値と既定値にまとめています。

保存したクエリの管理

• 一覧画面のカードをクリックすると編集画面が開き、保存済みの SQL が自動実行されてプレビューが表示されます。
• カード右上のゴミ箱アイコンで削除できます。ダッシュボードから参照されているクエリを削除すると、そのウィジェットは表示できなくなります。
• 削除した直後に出る通知の 「元に戻す」 ですぐ取り消せます。通知を閉じたあとも、一覧下部の 「ゴミ箱」 に 30 日間残っていて戻せます。30 日を過ぎると自動で完全に削除されます。
• 保存したクエリは組織内で共有されます。

AI エージェントから使う

MCP 経由でも、同じ制限のもとで describe_query_schema（テーブル定義の取得）と run_query（実行）が使えます。AI に集計を依頼したいときに便利です。→ MCP 連携