まちのデータを、切る。たどる。問う。

欄を埋める

何を数えるか（QuerySpec）と、どう見せるか（ViewSpec）の欄を、カタログの語から選びます。ダッシュボードの場面では人が書き、問いの画面では分類 API の Jev が選びます。Jev は文章を書きません。候補から選ぶ、採点する、はい/いいえに答える、の三つだけを行います。

{
  "data_kind": "citizen_requests",
  "measure": "request_count",
  "dimension": "town",
  "time_grain": "none",
  "period": "all_time",
  "scope": "whole_city",
  "ops": [
    "top_n"
  ]
}

{
  "layout": "ranked_list",
  "hero": "table",
  "emphasis": "max",
  "sort": "value_desc"
}

SQL に組み立てる

コンパイラが、選ばれた語から決まった規則で SQL を組み立てます。下の SQL は、「要望がいちばん多い町はどこ？」から実際に組み立てたものです。

この問いから組み立てた SQL

WITH "base" AS (SELECT ("citizen_requests"."town_code")::VARCHAR AS "dim_key", ("citizen_requests"."town_name")::VARCHAR AS "dim_label"
  FROM "citizen_requests"
  WHERE ("citizen_requests"."town_code" IS NOT NULL)),
"agg" AS (SELECT "dim_key", "dim_label", (count(*))::INTEGER AS "value"
  FROM "base"
  GROUP BY "dim_key", "dim_label"),
"ranked" AS (SELECT "dim_key", "dim_label", "value", (row_number() OVER (ORDER BY "value" DESC NULLS LAST, "dim_key" ASC NULLS LAST))::INTEGER AS "rank"
  FROM "agg")
SELECT "dim_key", "dim_label", "value", "rank"
  FROM "ranked"
  WHERE ("rank" <= 10)
  ORDER BY "rank" ASC NULLS LAST, "dim_key" ASC NULLS LAST

ブラウザで集計する

ブラウザの中の DuckDB が集計します。集計をサーバに投げません。

画面を描く

ViewSpec から組み立てた画面の仕様で、地図とグラフを描きます。ダッシュボードの本文の数字も、集計の結果から差し込みます。