render 演算子

[ バージョン ] ドロップダウン リストを使用してサービスを切り替えます。 ナビゲーションの詳細を確認します。
適用対象: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

render演算子は、クエリ結果を視覚化するようにユーザー エージェントに指示します。 これはクエリの最後の演算子である必要があり、単一の表形式データ ストリームを生成するクエリでのみ機能します。

演算子はデータを変更しません。 代わりに、クエリからの視覚化命令を含む、結果の拡張プロパティに "視覚化" 注釈が追加されます。 Kusto.Explorer や Azure Data Explorer Web UI など、さまざまなユーザー エージェントは、この情報に基づいてさまざまな視覚化を解釈してサポートします。

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

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

ヒント

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

Note

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

構文

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

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

パラメーター

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

ビジュアル化

視覚化 説明 図
anomalychart タイムチャートに似ていますが、 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 階層データを入れ子になった四角形のセットとして表示します。

Note

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

視覚化 説明 図
areachart 面グラフ。 最初の列は x 軸であり、数値列である必要があります。 その他の数値列は y 軸です。
barchart 最初の列は x 軸で、テキスト、datetime、または数値を指定できます。 他の列は数値であり、水平ストリップとして表示されます。
columnchart barchart と同様ですが、横方向のストリップではなく、縦方向のストリップになります。
piechart 最初の列は色軸で、2 番目の列は数値です。
scatterchart 点グラフ。 最初の列は x 軸であり、数値列である必要があります。 その他の数値列は y 軸です。
table 既定 - 結果はテーブルとして表示されます。
timechart 線グラフ。 最初の列は x 軸であり、datetime である必要があります。 他の (数値) 列は y 軸です。 1 つの文字列の列の値が、数値列を "グループ化" し、グラフ内の異なる線を作成するために使用されます (それ以外の文字列の列は無視されます)。
視覚化 説明 図
anomalychart タイムチャートに似ていますが、 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 軸の値に分割する方法。 詳細については、「 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 つのグラフがレンダリングされます。 最大 5 つのパネル。

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

値のシーケンスをレンダリングするには、 linechart、 timechart、 areachartなど、いくつかの視覚化を使用します。 これらの視覚化は、概念モデルに従います。

  • テーブル内の 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
  • Last updated on