チャート
実装済み結果が返ってくる前に、チャートタブに何を描かせるか指示しておけます。
チャートディレクティブは、結果の チャート コメントからタブを作成します。対話的に設定できるのと同じチャートですが、設定はクエリと一緒に保存され、実行するたびに復元されます。使うのは ビュー チャートタブを開くためのディレクティブと チャート 型、ラベル、系列、集計を指定するディレクティブ。
構文
-- sqlly view: chart
-- sqlly chart: kind:<type>[; label:<col>][; values:<cols>][; aggregate:<agg>][; order:<order>][; top:<n>][; navigate:<true|false>][; result:<n>]
フィールドは次で区切られます ; そして次のように書かれます key:value; 順序は関係ありません。次のみ kind: が必須で、残りは省略するとチャートのデフォルトが使われます。列名は柔軟なので、 [Region], `Region`、そして "Region" 同じ列にすべて解決します。
| フィールド | 意味 |
|---|---|
kind: | チャートのタイプ: bar, line, area, scatter, histogram, pie、または donut (必須)。 |
label:col | 値がカテゴリのラベルになる列。デフォルトは最初のテキスト列です。 |
values:col[,col…] | 系列としてプロットする数値列。デフォルトでは数値列を自動検出します。 |
aggregate:agg | カテゴリごとに行を折りたたむ: none, sum, average, minimum, maximum、または count. (avg/min/max も受け付けます。) |
order:order | カテゴリの順序: source, category (A–Z)、または value (高い順)。 |
top:n | 最大で次の件数を保持 n 並べ替え後のカテゴリ。 |
navigate:true|false | マークをクリックすると、[グリッド] タブでそのソース行が選択されます (デフォルト true). |
result:n | このチャートが属する結果セットの番号です(1 から数えます)。既定値は最初の結果セットです。 |
例
-- sqlly view: chart
-- sqlly chart: kind:bar; label:Region; values:Sales
SELECT Region, Sales FROM sales;
2 つの系列を、カテゴリごとに合計し、大きい順に表示するには:
-- sqlly view: chart
-- sqlly chart: kind:line; label:Month; values:Revenue,Cost; aggregate:sum; order:value; top:12
SELECT Month, Revenue, Cost FROM monthly;
バッチが複数の結果セットを返すとき、 result: を指定すると、後の結果セットからチャートを描きます:
-- sqlly chart: kind:bar; label:Region; values:Total; result:2
SELECT COUNT(*) FROM sales;
SELECT Region, Total FROM sales;
チャートの種類
それぞれの kind: 値ごとに異なるマークが描画されます。下のギャラリーに想定される表示を示しています。スクリーンショットのプレースホルダーは、実際のキャプチャを待っています。














コメントは独立した行に書きます。 置く
view: chart クエリの最初の非空行で。 chart: それぞれ独立したコメント行に置けます。有効なチャートヒントが複数ある場合は、最後のものが優先されます。