共用方式為

render 運算子

  • 發行項

適用於：✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel

指示使用者代理程式呈現查詢結果的視覺效果。

轉譯運算子必須是查詢中的最後一個運算符，而且只能與產生單一表格式數據流結果的查詢搭配使用。 轉譯運算子不會修改數據。 它會將註釋 （“Visualization”） 插入結果的擴充屬性。 批註包含查詢中 運算子提供的資訊。 視覺效果信息的解譯是由使用者代理程式所完成。 不同的代理程式，例如 Kusto.Explorer 或 Azure 數據總管 Web UI，可能支援不同的視覺效果。

轉譯運算子的數據模型會查看表格式數據，就好像它有三種數據行：

  • x 軸資料行（由 xcolumn 屬性表示）。
  • 數列資料行 （屬性所指出的任意數目數據 series 行。對於每筆記錄，這些數據行的合併值會定義單一數列，而且圖表的數列數目與有相異的結合值一樣多。
  • y 軸數據行（屬性所指示的任何數目數據 ycolumns 行）。 對於每筆記錄，數列的度量量值（圖表中的“點”）與有 Y 軸數據行一樣多。

提示

  • 使用 where和 summarize top 來限制您顯示的磁碟區。
  • 排序數據以定義 X 軸的順序。
  • 使用者代理程式可以「猜測」查詢未指定的屬性值。 特別是，在結果架構中具有「不感興趣」的數據行，可能會轉譯成猜測錯誤。 嘗試在發生這種情況時投影這類數據行。

注意

有些視覺效果僅適用於 Azure 數據總管儀錶板。 如需詳細資訊，請參閱 儀錶板特定的視覺效果。

語法

T| render 視覺效果 [with ( propertyName = propertyValue [, ...]])

深入瞭解 語法慣例。

參數

姓名 類型​​ 必要 描述
T string ✔️ 輸入數據表名稱。
可視化 string ✔️ 表示要使用的視覺效果類型。 必須是下列清單中的其中一個支援值。
propertyName、 propertyValue string 索引鍵/值屬性組的逗號分隔清單。 請參閱 支持的屬性。

視覺效果

可視化 描述 範例說明
anomalychart 類似於時間圖，但會使用 series_decompose_anomalies 函式反白顯示異常。
areachart 分區圖。
barchart 顯示為水準帶狀。
card 第一個結果記錄會被視為純量值集，並顯示為卡片。
columnchart 如同 barchart 垂直帶狀，而不是水平帶狀。
ladderchart 最後兩個數據行是 x 軸，其他數據行則為 y 軸。
linechart 折線圖。
piechart 第一個數據行是色彩軸，第二欄是數值。
pivotchart 顯示數據透視表和圖表。 用戶可以以互動方式選取數據、數據行、數據列和各種圖表類型。
scatterchart 點圖。
stackedareachart 堆疊分區圖。
table 預設值 - 結果會顯示為數據表。
timechart 折線圖。 第一個數據行是 x 軸，而且必須是 datetime。 其他 （數值） 資料行是 Y 軸。
timepivot 事件時間線的互動式導覽（在時間軸上樞紐）
treemap 將階層式數據顯示為一組巢狀矩形。

注意

階梯圖、樞紐分析圖、timepivot 和樹形圖視覺效果可用於 Kusto.Explorer，但無法在 Azure 數據總管 Web UI 中使用。

視覺效果 描述 範例說明
areachart 分區圖。 第一個數據行是 x 軸，應該是數值數據行。 其他數值數據行是 y 軸。
barchart 第一個數據行是 x 軸，可以是文字、日期時間或數值。 其他數據行是數值，會顯示為水準帶狀。
columnchart 如同 barchart 垂直帶狀，而不是水平帶狀。
piechart 第一個數據行是色彩軸，第二欄是數值。
scatterchart 點圖。 第一個數據行是 x 軸，應該是數值數據行。 其他數值數據行是 y 軸。
table 預設值 - 結果會顯示為數據表。
timechart 折線圖。 第一個數據行是 x 軸，而且應該是 datetime。 其他 （數值） 資料行是 Y 軸。 有一個字串數據行的值可用來「群組」數值數據行，並在圖表中建立不同的線條（會忽略進一步的字串數據行）。
可視化 描述 範例說明
anomalychart 類似於時間圖，但會使用 series_decompose_anomalies 函式反白顯示異常。
areachart 分區圖。
barchart 顯示為水準帶狀。
card 第一個結果記錄會被視為純量值集，並顯示為卡片。
columnchart 如同 barchart 垂直帶狀，而不是水平帶狀。
linechart 折線圖。
piechart 第一個數據行是色彩軸，第二欄是數值。
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 堆疊 “bars”。
stacked100 堆疊「橫條」，並將每個橫條伸展至與其他人相同的寬度。
columnchart default 每個「數據行」各自站立。
unstacked 與 default 相同。
stacked 堆疊 「columns」 一個頂端。
stacked100 堆疊 「數據行」，並將每個數據行伸展至與其他人相同的高度。
scatterchart map 預期的數據行為 [經度、緯度] 或 GeoJSON 點。 數列數據行是選擇性的。 如需詳細資訊，請參閱 地理空間視覺效果。
piechart map 預期的數據行為 [經度、緯度] 或 GeoJSON 點、色彩軸和數值。 Kusto Explorer 桌面支援。 如需詳細資訊，請參閱 地理空間視覺效果。

ysplit 屬性

某些視覺效果支援分割成多個 Y 軸值：

ysplit 描述
none 所有數列數據都會顯示單一 Y 軸。 (預設值)
axes 單一圖表會以多個 Y 軸顯示（每個數列一個）。
panels 每個 ycolumn 值都會轉譯一張圖表（最多一些限制）。

如何轉譯連續數據

使用數個視覺效果來轉譯值的序列，例如、 linecharttimechart和 areachart。 這些視覺效果具有下列概念模型：

  • 數據表中的一個數據行代表數據的 X 軸。 這個數據行可以使用 屬性明確定義 xcolumn 。 如果未定義，使用者代理程式會挑選適合視覺效果的第一個數據行。
    • 例如：在視覺效果中 timechart ，使用者代理程式會使用第一個 datetime 數據行。
    • 如果此數據行的類型 dynamic 為 ，且其保存數位，則陣列中的個別值會被視為 x 軸的值。
  • 數據表中的一或多個數據行代表一或多個量值，這些量值會因 X 軸而異。 您可以使用 屬性明確定義 ycolumns 這些資料行。 如果未定義，使用者代理程式會挑選適合視覺效果的所有數據行。
    • 例如：在視覺效果中 timechart ，使用者代理程式會使用所有資料行搭配未指定數值，否則為 。
    • 如果 x 軸是陣列，則每個 y 軸的值也應該是類似長度的陣列，而每個 Y 軸都發生在單一數據行中。
  • 數據表中的零個或多個數據行代表一組唯一的維度，將量值分組在一起。 這些數據行可由 屬性指定 series ，或者使用者代理程式會自動從未指定的數據行中挑選這些數據行。

注意

轉譯運算子的數據模型會查看表格式數據，就好像它有三種數據行：

  • 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