チャート

実装済み

結果が返ってくる前に、チャートタブに何を描かせるか指示しておけます。

チャートディレクティブは、結果の チャート コメントからタブを作成します。対話的に設定できるのと同じチャートですが、設定はクエリと一緒に保存され、実行するたびに復元されます。使うのは ビュー チャートタブを開くためのディレクティブと チャート 型、ラベル、系列、集計を指定するディレクティブ。

構文

-- 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: 値ごとに異なるマークが描画されます。下のギャラリーに想定される表示を示しています。スクリーンショットのプレースホルダーは、実際のキャプチャを待っています。

SQLly
SQLly 棒グラフSQLly 棒グラフ
kind:bar、0 を基準線として、カテゴリごと・系列ごとに 1 本の棒をグループ化したもの。
SQLly
SQLly 折れ線グラフSQLly 折れ線グラフ
kind:line、系列ごとに 1 本の折れ線で、NULL の位置では途切れます。
SQLly
SQLly エリアチャートSQLly エリアチャート
kind:area、0 を下限とする軸上の塗りつぶし折れ線。
SQLly
SQLly 散布図SQLly 散布図
kind:scatter、カテゴリごとの点マーカーで、ばらつきの把握に適しています。
SQLly
SQLly ヒストグラムSQLly ヒストグラム
kind:histogram、1 つの数値列を、見やすい境界のビンに区分けしたもの。
SQLly
SQLly 円グラフSQLly 円グラフ
kind:pie、非負の 1 つの系列を放射状に表した構成比。
SQLly
SQLly ドーナツチャートSQLly ドーナツチャート
kind:donut - 中央をくり抜いた円グラフ。
コメントは独立した行に書きます。 置く view: chart クエリの最初の非空行で。 chart: それぞれ独立したコメント行に置けます。有効なチャートヒントが複数ある場合は、最後のものが優先されます。