render 運算子

  • 發行項

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

轉譯運算子必須是查詢中的最後一個運算符，而且只能與產生單一表格式數據流結果的查詢搭配使用。 轉譯運算子不會修改數據。 其會將註釋 (「視覺效果」) 插入到結果的擴充屬性中。 註釋內包含查詢中的運算子所提供的資訊。 視覺效果資訊的解讀則由使用者代理程式進行。 不同的代理程式，例如 Kusto.Explorer 或 Azure Data Explorer Web UI，可能支援不同的視覺效果。

render 運算子的資料模型會查看表格式資料，情形就像其有三種資料行：

  • X 軸資料行 (以 xcolumn 屬性表示)。
  • 數列數據行會 (property.) 針對每個記錄所指示 series 的任何數目數據行，這些數據行的合併值會定義單一數位，而圖表的數列數目與有相異的組合值一樣多。
  • Y 軸資料行 (以 ycolumns 屬性表示的任意數目資料行)。 針對每一筆記錄，數列的量值 (圖表中的「點」) 數目會與 Y 軸資料行相同。

提示

  • 使用 where、summarize 和 top 來限制您顯示的資料量。
  • 將資料排序以定義 X 軸的順序。
  • 使用者代理程式可自由「猜測」查詢未指定的屬性值。 特別的是，若結果的結構描述中有「無意義」的資料行，則可能會讓其猜測錯誤。 當這種情況發生時，請嘗試排除這類資料行。

注意

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

Syntax

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

深入瞭解 語法慣例。

參數

名稱 類型 必要 Description
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 軸，而且必須是日期時間。 其他 (數值) 資料行則為 Y 軸。
timepivot 在事件時間軸上進行互動式導覽 (在時間軸上進行樞紐分析)
treemap 將階層式數據顯示為一組巢狀矩形。

注意

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

視覺效果 描述 範例說明
areachart 區域圖。 第一個資料行是 X 軸，而且應該是數值資料行。 其他數值資料行則為 Y 軸。
barchart 第一個資料行是 X 軸，而且可以是文字、日期時間或數值。 其他資料行是數值，會顯示為橫條。
columnchart 如同 barchart，但具有直條，而不是橫條。
piechart 第一個資料行是色彩座標軸，第二個資料行是數值。
scatterchart 點圖。 第一個資料行是 X 軸，而且應該是數值資料行。 其他數值資料行則為 Y 軸。
table 預設值 - 結果會顯示為資料表。
timechart 折線圖。 第一個資料行是 X 軸，而且應該是日期時間。 其他 (數值) 資料行則為 Y 軸。 有一個字串數據行，其值是用來「群組」數值數據行，並在圖表中建立不同的線條， (會忽略其他字串數據行) 。
可視 化 描述 範例說明
anomalychart 類似於時間圖，但會使用 series_decompose_anomalies 函式來醒目提示異常。
areachart 區域圖。
barchart 顯示為水準帶。
card 第一個結果記錄會視為純量值集合，並顯示為卡片。
columnchart 如同 barchart，但具有直條，而不是橫條。
linechart 折線圖。
piechart 第一個資料行是色彩座標軸，第二個資料行是數值。
scatterchart 點圖。
stackedareachart 堆疊區域圖。
table 預設值 - 結果會顯示為資料表。
timechart 折線圖。 第一個資料行是 X 軸，而且必須是日期時間。 其他 (數值) 資料行則為 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 所有數列資料都會顯示單一 Y 軸。 (預設值)
axes 單一圖表會顯示多個 Y 軸 (每個數列一個)。
panels 會針對每個 ycolumn 值 (有一定上限) 呈現一個圖表。

如何轉譯連續數據

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

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

相關內容

注意

render 運算子的資料模型會查看表格式資料，情形就像其有三種資料行：

  • 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