render 運算子

  • 發行項

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

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

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

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

提示

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

Syntax

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

參數

名稱 類型 必要 Description
T 字串 ✓ 輸入資料表名稱。
可視 化 字串 ✓ 指出要使用的 視覺效果 類型。 必須是下列清單中的其中一個支援值。
propertyName， propertyValue 字串 索引鍵/值屬性組的逗號分隔清單。 請參閱 支援的屬性。

視覺效果

可視 化 描述
anomalychart 類似於時間圖，但會使用 series_decompose_anomalies 函式來醒目提示異常。
areachart 區域圖。
barchart 顯示為水準帶狀。
card 第一個結果記錄會視為純量值集合，並顯示為卡片。
columnchart 如同 barchart，但具有直條，而不是橫條。
ladderchart 最後兩個資料行是 X 軸，其他資料行則是 Y 軸。
linechart 折線圖。
piechart 第一個資料行是色彩座標軸，第二個資料行是數值。
pivotchart 顯示樞紐分析表和圖表。 使用者可以透過互動方式選取資料、資料行、資料列和各種圖表類型。
scatterchart 點圖。
stackedareachart 堆疊區域圖。
table 預設值 - 結果會顯示為資料表。
timechart 折線圖。 第一個資料行是 X 軸，而且必須是日期時間。 其他 (數值) 資料行則為 Y 軸。
timepivot 在事件時間軸上進行互動式導覽 (在時間軸上進行樞紐分析)

注意

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

視覺效果 描述
areachart 區域圖。 第一個資料行是 X 軸，而且應該是數值資料行。 其他數值資料行則為 Y 軸。
barchart 第一個資料行是 X 軸，而且可以是文字、日期時間或數值。 其他資料行是數值，會顯示為橫條。
columnchart 如同 barchart，但具有直條，而不是橫條。
piechart 第一個資料行是色彩座標軸，第二個資料行是數值。
scatterchart 點圖。 第一個資料行是 X 軸，而且應該是數值資料行。 其他數值資料行則為 Y 軸。
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