render 演算子

クエリ結果の視覚化をレンダリングするようにユーザー エージェントに指示します。

render 演算子はクエリの最後の演算子である必要があり、1 つの表形式データ ストリーム結果を生成するクエリでのみ使用できます。 render 演算子はデータを変更しません。 結果の拡張プロパティに注釈 ("Visualization") が挿入されます。 注釈には、クエリ内の演算子によって提供される情報が含まれます。 視覚化情報の解釈は、ユーザー エージェントによって行われます。 Kusto など、さまざまなエージェント。エクスプローラーまたは Azure Data Explorer Web UI では、さまざまな視覚化がサポートされる場合があります。

render 演算子のデータ モデルでは、表形式のデータは 3 種類の列があるように認識されます。

  • x 軸の列 (xcolumn プロパティによって示されます)。
  • 系列列 (プロパティによって示される任意の数の series 列)。各レコードに対して、これらの列の結合値によって 1 つの系列が定義され、グラフには個別の結合値があるのと同じ数の系列が含まれます。
  • y 軸の列 (ycolumns プロパティによって示される任意の数の列)。 レコードごとに、系列には y 軸の列と同じ数の測定値 (グラフ内の "ポイント") があります。

ヒント

  • 表示する量を制限するには、wheresummarizetop を使用します。
  • x 軸の順序を定義するには、データを並べ替えます。
  • クエリによって指定されていないプロパティの値は、ユーザー エージェントで自由に "推測" できます。 具体的には、結果のスキーマに "興味のない" 列があると、誤った推測に変換される可能性があります。 その場合は、そのような列に project-away を使用してみてください。

注意

Azure Data Explorer ダッシュボードでのみ使用できる視覚化がいくつかあります。 詳細については、「 ダッシュボード固有のビジュアル」を参照してください。

構文

T|rendervisualization [with(propertyName=propertyValue [, ...])]

構文規則について詳しく知る。

パラメーター

名前 必須 説明
T string ✔️ 入力テーブル名。
可視 化 string ✔️ 使用する 視覚化 の種類を示します。 次の一覧でサポートされている値のいずれかである必要があります。
propertyNamepropertyValue string キーと値のプロパティペアのコンマ区切りのリスト。 「サポートされているプロパティ」を参照してください。

グラフ

可視 化 説明
anomalychart timechart に似ていますが、series_decompose_anomalies 関数を使用して異常が強調表示されます。
areachart 面グラフ。
barchart 水平ストリップとして表示されます。
card 最初の結果レコードは、スカラー値のセットとして扱われ、カードとして表示されます。
columnchart barchart と同様ですが、横方向のストリップではなく、縦方向のストリップになります。
ladderchart 最後の 2 つの列は x 軸であり、他の列は y 軸です。
linechart 線グラフ。
piechart 最初の列は色の軸、2 番目の列は数値です。
pivotchart ピボット テーブルとグラフが表示されます。 ユーザーは、データ、列、行、さまざまなグラフの種類を、対話的に選択できます。
scatterchart 点グラフ。
stackedareachart 積み上げ面グラフ。
table 既定 - 結果はテーブルとして表示されます。
timechart 線グラフ。 最初の列は x 軸で、datetime を指定する必要があります。 他の (数値) 列は y 軸です。
timepivot イベントのタイムラインでの対話型ナビゲーション (時間軸でのピボット)
treemap 階層データを入れ子になった四角形のセットとして表示します。

注意

Kusto では、ラダーグラフ、ピボットグラフ、タイムピボット、ツリーマップの視覚化を使用できます。エクスプローラーが、Azure Data Explorer Web UI では使用できません。

視覚化 説明
areachart 面グラフ。 最初の列は x 軸であり、数値列である必要があります。 その他の数値列は y 軸です。
barchart 最初の列は x 軸であり、テキスト、日時、または数値を使用できます。 他の列は数値であり、横方向のストリップとして表示されます。
columnchart barchart と同様ですが、横方向のストリップではなく、縦方向のストリップになります。
piechart 最初の列は色の軸、2 番目の列は数値です。
scatterchart 点グラフ。 最初の列は x 軸であり、数値列である必要があります。 その他の数値列は y 軸です。
table 既定 - 結果はテーブルとして表示されます。
timechart 線グラフ。 最初の列は x 軸で、日時を指定する必要があります。 他の (数値) 列は y 軸です。 1 つの文字列の列の値が、数値列を "グループ化" し、グラフ内の異なる線を作成するために使用されます (それ以外の文字列の列は無視されます)。
可視 化 説明
anomalychart timechart に似ていますが、series_decompose_anomalies 関数を使用して異常が強調表示されます。
areachart 面グラフ。
barchart 水平ストリップとして表示されます。
card 最初の結果レコードは、スカラー値のセットとして扱われ、カードとして表示されます。
columnchart barchart と同様ですが、横方向のストリップではなく、縦方向のストリップになります。
linechart 線グラフ。
piechart 最初の列は色の軸、2 番目の列は数値です。
scatterchart 点グラフ。
stackedareachart 積み上げ面グラフ。
table 既定 - 結果はテーブルとして表示されます。
timechart 線グラフ。 最初の列は x 軸で、datetime を指定する必要があります。 他の (数値) 列は y 軸です。

サポートされているプロパティ

PropertyName/PropertyValue は、レンダリング時に使用される追加情報を示します。 すべてのプロパティは省略可能です。 サポートされているプロパティは次のとおりです。

PropertyName PropertyValue
accumulate 各メジャーの値を、それより前にあるすべてのものに追加するかどうか。 (true または false)
kind 視覚化の種類のさらに詳細な設定。 詳細については、「プロパティ」を参照してくださいkind
legend 凡例を表示するかどうか (visible または hidden)。
series レコードごとに結合された値によってそのレコードが属する系列が定義される、コンマ区切りの列のリスト。
ymin Y 軸に表示される最小値。
ymax Y 軸に表示される最大値。
title 視覚化のタイトル (string 型)。
xaxis x 軸のスケールを設定する方法 (linear または log)。
xcolumn x 軸に使用される結果の列。
xtitle x 軸のタイトル (string 型)。
yaxis y 軸のスケールを設定する方法 (linear または log)。
ycolumns x 列の値ごとに提供された値で構成される列のコンマ区切りのリスト。
ysplit 複数の視覚化を分割する方法。 詳細については、「プロパティ」を参照してくださいy-split
ytitle y 軸のタイトル (string 型)。
anomalycolumns anomalychart にのみ関連するプロパティ。 異常系列と見なされ、グラフ上に点として表示される列のコンマ区切りのリスト
PropertyName PropertyValue
kind 視覚化の種類のさらに詳細な設定。 詳細については、「プロパティ」を参照してくださいkind
series レコードごとに結合された値によってそのレコードが属する系列が定義される、コンマ区切りの列のリスト。
title 視覚化のタイトル (string 型)。

kind プロパティ

この視覚化は、 プロパティを kind 指定することでさらに詳しく説明できます。 このプロパティのサポートされる値は次のとおりです。

視覚化 kind [説明]
areachart default 各 "面" は独立しています。
unstacked default と同じ。
stacked "面" を右側に積み上げます。
stacked100 "面" を右側に積み上げ、それぞれを他と同じ幅に伸縮します。
barchart default 各 "横棒" は独立しています。
unstacked default と同じ。
stacked "横棒" を積み上げます。
stacked100 "横棒" を積み上げて、それぞれを他と同じ幅に伸縮します。
columnchart default 各 "縦棒" は独立しています。
unstacked default と同じ。
stacked "縦棒" を他の上に積み上げます。
stacked100 "縦棒" を積み上げて、それぞれを他と同じ高さに伸縮します。
scatterchart map 予期される列は、[経度、緯度] または GeoJSON ポイントです。 系列の列は省略可能です。 詳細については、「 地理空間の視覚化」を参照してください。
piechart map 予期される列は、[経度、緯度]、GeoJSON ポイント、カラー軸、および数値です。 Kusto Explorer デスクトップでサポートされます。 詳細については、「 地理空間の視覚化」を参照してください。

ysplit プロパティ

一部の視覚化では、複数の y 軸値への分割がサポートされています。

ysplit [説明]
none 1 つの y 軸がすべての系列データに表示されます。 (既定値)。
axes 1 つのグラフに、複数の y 軸 (系列ごとに 1 つ) が表示されます。
panels ycolumn の値ごとに 1 つのグラフが表示されます (何らかの上限まで)。

連続データをレンダリングする方法

linecharttimechartareachart など、いくつかの視覚化が、値のシーケンスをレンダリングするために使用されます。 これらの視覚化には、次のような概念モデルがあります。

  • テーブル内の 1 つの列は、データの x 軸を表します。 この列は、xcolumn プロパティを使用して明示的に定義できます。 定義されていない場合、ユーザー エージェントは視覚化に適した最初の列を選択します。
    • たとえば、視覚化では timechart 、ユーザー エージェントは最初 datetime の列を使用します。
    • この列の型が dynamic であり、配列を保持している場合、配列内の個々の値は x 軸の値として扱われます。
  • テーブル内の 1 つ以上の列は、x 軸ごとに異なる 1 つ以上のメジャーを意味します。 これらの列は、ycolumns プロパティを使用して明示的に定義できます。 定義されていない場合、ユーザー エージェントは視覚化に適したすべての列を選択します。
    • たとえば、視覚化では timechart 、ユーザー エージェントは、それ以外の方法で指定されていない数値を持つすべての列を使用します。
    • x 軸が配列の場合、各 y 軸の値も同様の長さの配列である必要があり、各 y 軸は 1 つの列で表されます。
  • テーブル内の 0 個以上の列は、メジャーをグループ化する、ディメンションの個別のセットを表します。 これらの列は series プロパティで指定できます。または、ユーザー エージェントは、指定されていない列から自動的に選択します。

Note

render 演算子のデータ モデルでは、表形式のデータは 3 種類の列があるように認識されます。

  • x 軸の列 (xcolumn プロパティによって示されます)。
  • 系列の列 (series プロパティによって示される任意の数の列)。
  • y 軸の列 (ycolumns プロパティによって示される任意の数の列)。 レコードごとに、系列には y 軸の列と同じ数の測定値 (グラフ内の "ポイント") があります。

InsightsMetrics
| where Computer == "DC00.NA.contosohotels.com"
| where Namespace  == "Processor" and Name == "UtilizationPercentage"
| summarize avg(Val) by Computer, bin(TimeGenerated, 1h)
| render timechart