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 值 (有一定上限) 呈現一個圖表。 |
如何轉譯連續數據
使用數個視覺效果來轉譯值序列,例如、 linechart
timechart
和 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
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應