render 運算子

使用 版本 下拉選單切換服務。 了解更多關於導航的資訊。
Apply to： ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure 監視器 ✅ Microsoft Sentinel

操作員 render 指示使用者代理視覺化查詢結果。 它必須是查詢的最後一個運算子，且僅適用於產生單一表格資料流的查詢。

操作員不會修改資料。 相反地，它會在結果的擴展屬性中加入一個「視覺化」註解，包含查詢中的視覺化指示。 不同的使用者代理程式，如 Kusto.Explorer 或 Azure Data Explorer 網頁介面，會根據這些資訊解讀並支援不同的視覺化。

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

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

提示

  • 使用 where和 summarizetop 來限制您顯示的磁碟區。
  • 排序數據以定義 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 將階層式數據顯示為一組巢狀矩形。

注意

梯形圖、樞紐圖、時間樞紐和樹狀圖視覺化可以在 Kusto.Explorer 中使用，但在 Azure Data Explorer 網頁介面中無法使用。

視覺效果 描述 範例說明
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 軸值。 如需詳細資訊，請參閱 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 值都會轉譯一張圖表。 最多五個面板。

如何轉譯連續數據

要渲染數值序列，請使用多種視覺化，如 linechart、 timechart、 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
  • Last updated on