メインコンテンツへスキップ
公開されたデータの列を確認し、サーバーで絞り込み、集計します。

データを選ぶ

データのコンテンツは、--type data で探します。結果には、列の名前と型、行数も出ます。
結果に出た id を控えます。以降のコマンドで使います。

列を確認する

集計の前に、列の名前と型を確認します。名前は、1 文字も違わずに書く必要があります。
<id> は、データの id に置き換えます。--detail light は、列の名前と型、行数だけを返します。 行の中身を見たいときは、先頭の数行を取得します。
公開した人が全データを含めていないときは、返る行は公開時に保存したサンプルです。合計や絞り込みは、サンプルではなく、次の dataset query で行います。

絞り込みと集計

次の例は、region 列の値ごとに sales 列の合計を求め、大きい順に 5 件を返します。
<dataset_id> はデータの id、region は実際の列の名前に置き換えます。実行結果は、id が hI6jK7lM8n のデータ(Sales Orders)で、地域ごとの売上を合計したものです。 実行結果
  • --mode aggregate は、--dimensions でグループに分け、--metrics を計算します。
  • --mode rows は、条件に合う行を取得します。--columns で返す列を指定します。
  • rows は最大 1,000 行、aggregate は最大 500 行です。続きを取得する指定はありません。結果の has_more が true なら、絞り込むか、集計します。
  • 結果には、データのバージョンと更新時刻が含まれます。数値を人に伝えるときは、いつのデータで計算したかも伝えます。
条件に合う行を取得するときは、--mode rows を使います。--columns が必要で、--filters で行を絞り込みます。次の例は、region が Kanto の行について、2 つの列を返します。
operator は比較の方法です。データごとに使える operator は、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 になっていないかを確認します。