データを選ぶ
データのコンテンツは、--type data で探します。結果には、列の名前と型、行数も出ます。
列を確認する
集計の前に、列の名前と型を確認します。名前は、1 文字も違わずに書く必要があります。--detail light は、列の名前と型、行数だけを返します。
行の中身を見たいときは、先頭の数行を取得します。
絞り込みと集計
次の例は、region 列の値ごとに sales 列の合計を求め、大きい順に 5 件を返します。--modeaggregate は、--dimensionsでグループに分け、--metricsを計算します。--moderows は、条件に合う行を取得します。--columnsで返す列を指定します。- rows は最大 1,000 行、aggregate は最大 500 行です。続きを取得する指定はありません。結果の has_more が true なら、絞り込むか、集計します。
- 結果には、データのバージョンと更新時刻が含まれます。数値を人に伝えるときは、いつのデータで計算したかも伝えます。
--mode rows を使います。--columns が必要で、--filters で行を絞り込みます。次の例は、region が Kanto の行について、2 つの列を返します。
expl server dataframe get-schema <id> --detail full の結果にあります。複数の条件を組み合わせる方法は、フィルタ条件を参照してください。
結果が大きすぎる場合は、dataframe export で CSV または Parquet のファイルにします。複数のデータを結合する方法は、dataset query のページを参照してください。
JSON で渡す引数の書き方
JSON は、データを書くための決まった形の文字列です。dimensions、metrics、sort などは、JSON で渡します。JSON 全体を単引用符(‘)で囲み、中の文字列は二重引用符(“)で囲みます。
metrics の alias は必須です。英字、数字、_ だけで、数字で始めず、64 文字までです。sort では、出力の列の名前を field で指定します。
書き方を間違えたときの表示と、直し方です。
問い合わせできないデータ
全データを含めずに公開されたデータは、サーバーでは問い合わせできません。dataset query は、次のエラーで失敗します。
検索結果や
--detail light の結果では、問い合わせできるかどうかは分かりません。--detail full で、結果の query.available が false になっていないかを確認します。
