橫條圖

條形圖視覺效果在查詢結果中至少需要兩個數據行。 根據預設，第一個數據行會當做 Y 軸使用。 此數據列可以包含文字、日期時間或數值數據類型。 其他數據行會當做 X 軸使用，並包含要顯示為水平線的數值數據類型。 條形圖主要用於比較數值和名義離散值，其中每一條線的長度代表其值。

注意

此視覺效果只能在 轉譯運算符的內容中使用。

Syntax

T|renderbarchart [with(propertyName=propertyValue [, ...])]

深入瞭解 語法慣例。

參數

名稱	類型	必要	Description
T	string	✔️	輸入數據表名稱。
propertyName， propertyValue	string		索引鍵/值屬性組的逗號分隔清單。 請參閱 支持的屬性。

支援的屬性

所有屬性都是選擇性的。

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 資料行的每個值所提供的值。
ytitle	Y 軸的標題 (屬於 string 類型)。
ysplit	如何將視覺效果分割成多個 Y 軸值。 如需詳細資訊，請參閱 ysplit 屬性。

ysplit 屬性

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

ysplit	描述
none	所有數列資料都會顯示單一 Y 軸。 此為預設值。
axes	單一圖表會顯示多個 Y 軸 (每個數列一個)。
panels	每個 ycolumn 值都會轉譯一張圖表。

支援的屬性

所有屬性都是選擇性的。

PropertyName	PropertyValue
kind	進一步詳述視覺效果種類。 如需詳細資訊，請參閱 kind 屬性。
series	以逗號分隔的資料行清單，其合併的每一筆記錄值會定義記錄所屬的數列。
title	視覺效果的標題 (屬於 string 類型)。

kind 屬性

藉由提供 kind 屬性，即可進一步詳細說明此視覺效果。 此屬性的支援值為：

kind 值	描述
default	每個「橫條」都獨立存在。
unstacked	與 default 相同。
stacked	堆疊「橫條」。
stacked100	堆疊「橫條」，並將每一個橫條延展為與其他橫條相同的寬度。

範例

轉譯條形圖

下列查詢會建立條形圖，其中顯示每個狀態的 Storm 事件數目，只篩選超過 10 個事件的那些狀態。 此圖表提供跨不同狀態之事件分佈的視覺表示法。

執行查詢

StormEvents
| summarize event_count=count() by State
| project State, event_count
| render barchart
    with (
    title="Storm count by state",
    ytitle="Storm count",
    xtitle="State",
    legend=hidden
    )

轉譯 stacked 條形圖

下列查詢會建立條 stacked 形圖，根據所選德州、加州和加州州的類型來顯示 Storm 事件的總數。 每個橫條都代表 storm 事件類型，堆棧橫條會依每個類型內的狀態顯示 Storm 事件的明細。

執行查詢

StormEvents
| where State in ("TEXAS", "CALIFORNIA", "FLORIDA")
| summarize EventCount = count() by EventType, State
| order by EventType asc, State desc
| render barchart with (kind=stacked)

轉譯 stacked100 條形圖

下列查詢會建立條 stacked100 形圖，根據所選德州、加州和加州州的類型來顯示 Storm 事件的總數。 此圖表顯示每個類型內狀態的 Storm 事件分佈。 雖然堆疊會以可視化方式加總至 100，但值實際上代表事件數目，而不是百分比。 此視覺效果有助於瞭解百分比和實際事件計數。

執行查詢

StormEvents
| where State in ("TEXAS", "CALIFORNIA", "FLORIDA")
| summarize EventCount = count() by EventType, State
| order by EventType asc, State desc
| render barchart with (kind=stacked100)

ysplit使用屬性

執行查詢

StormEvents
| summarize
    TotalInjuries = sum(InjuriesDirect) + sum(InjuriesIndirect),
    TotalDeaths = sum(DeathsDirect) + sum(DeathsIndirect)
    by bin(StartTime, 1d)
| project StartTime, TotalInjuries, TotalDeaths
| render barchart with (ysplit=axes)

若要將檢視分割成不同的面板，請指定 panels 而不是 axes：

執行查詢

StormEvents
| summarize
    TotalInjuries = sum(InjuriesDirect) + sum(InjuriesIndirect),
    TotalDeaths = sum(DeathsDirect) + sum(DeathsIndirect)
    by bin(StartTime, 1d)
| project StartTime, TotalInjuries, TotalDeaths
| render barchart with (ysplit=panels)