# クエリのパラメータ

---

## データセットの例

以下の記事では、会社の収益に関する簡単な例を用いて個々のクエリパラメータの機能について説明します。利用可能なデータセットは、次の通りです。

![problematique](picts/dataset.png ':size=300')

{各種クエリパラメータの使用方法を順を追って確認する}(#/jp/product/query-builder/queries/parameters/data.md)

---

## パラメータリスト

JSON形式のクエリの設定では、以下のパラメータが使用されます。
      
| パラメータ名 | 必須／任意 | 例 | 説明 |
| --- | --- | --- | --- |
| data.fields | 必須 | { "income":["sum"],"expense":["sum"]} | 返すフィールドとそれぞれのコンピュートモード（select、select\_distinct、sum、min、max、avg、count、count\_distinctを指定可）          |
| data.skip | 任意 | 10 | スキップする行数 |
| data.limit | 任意 | 100 | 返される行数 |
| data.hints | 任意 | True/False | クエリに対応する合計行数（data.limitを除外） |
| filter | 任意 | {  "date": {          "between": ["1420066800,1428962399"]  },  "client\_code": {          "in": ["08KD", "09CC"]  },  "creation\_date": {          "eq": ["2018-01-01"]  }} | クエリするデータにフィルターを適用。フィルターには、in、not\_in、between、not\_between、eq、not\_equal、like、not\_like、is\_null、is\_not\_null、gt (\>)、gte (\>=)、lt (\<)、lte (\<=)を指定可 |
| scale.fields | 任意 | ["date",["client\_code", "employee\_id"]] | クエリにスケール（グループ化）を適用。計算されたスケールや、複数のスケールを指定可 |
| evol.scale | 任意 | "year" | 変化に適用するスケール（weekday、week、month、quarter、semester、year） |
| evol.mode | 任意 | "date""weekday" | date：同じ日付との比較　weekday：同じ曜日との比較 |
| evol.depth | 任意 | 5 | 取得する変化の数 |
| total.all | 任意 | []["client\_code"] | 個別のスケールごとの合計クエリ数（オプション） |
| total.x | 任意 | ["client\_code"] | 特定の属性の合計クエリ数 |
| order | 任意 | {   "date":"asc"} | クエリ出力の順序（ascまたはdesc、デフォルトでasc） |
| table\_name | 任意 | "prim\_vehicles" | 特定のテーブルでクエリを強制的に実行 |
| database\_name | 任意 | "data\_prim""data\_mart" | 特定の階層でクエリを強制的に実行 |

{その他のクエリパラメータを確認する🦄}(#/jp/product/query-builder/queries/parameters/others.md)