条形图

  • 项目

条形图视觉对象至少需要查询结果中的两列。 默认情况下，第一列用作 y 轴。 此列可以包含文本、日期时间或数值数据类型。 其他列用作 x 轴，包含要显示为水平线的数值数据类型。 条形图主要用于比较数值和标称离散值，其中每条线的长度表示其值。

注意

此可视化效果只能在 render 运算符的上下文中使用。

语法

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

详细了解语法约定。

参数

客户 类型​​ 必需 说明
T string ✔ 输入表名称。
propertyName, propertyValue string 键值属性对的逗号分隔列表。 请参阅支持的属性。

支持的属性

所有属性都是可选的。

PropertyName PropertyValue
accumulate 是否将每个度量的值加到其所有前导度量中（true 或 false）。
kind 可视化效果种类的进一步细化。 有关详细信息，请参阅 kind property。
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 property。

ysplit 属性

此可视化效果支持拆分为多个 y 轴值：

ysplit 描述
none 为所有系列数据显示单个 y 轴。 这是默认值。
axes 单个图表将显示多个 y 轴（每个系列一个）。
panels 对于每个 ycolumn 值，均会呈现一个图表。

支持的属性

所有属性都是可选的。

PropertyName PropertyValue
kind 可视化效果种类的进一步细化。 有关详细信息，请参阅 kind property。
series 以逗号分隔的列列表，其中的每记录值组合定义了记录所属的系列。
title 可视化效果的标题（string 类型）。

kind 属性

可以通过提供 kind 属性来进一步详细阐述此可视化效果。 此属性支持的值为：

kind 值 说明
default 每个“条形”都独立存在。
unstacked 与 default 相同。
stacked 对“条形”进行堆叠。
stacked100 对“条形”进行堆叠，并将每个条形拉伸到与其他条形相同的宽度。

示例

呈现条形图

以下查询创建一个条形图，显示每个州的风暴事件数，并仅筛选事件数超过 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
    )

Screenshot of a labeled bar chart.

呈现 stacked 条形图

以下查询将创建一个 stacked 条形图，按类型显示德克萨斯州、加利福尼亚州和佛罗里达州选定州的风暴事件总数。 每个条形表示一种风暴事件类型，堆叠条形图显示每种类型中按州划分的风暴事件细分。

运行查询

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

Scrrenshot of a stacked bar chart visualization.

呈现 stacked100 条形图

以下查询将创建一个 stacked100 条形图，按类型显示德克萨斯州、加利福尼亚州和佛罗里达州选定州的风暴事件总数。 该图表显示每种类型中各州风暴事件的分布情况。 尽管堆叠的总和在视觉上为 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)

Screenshot of a stacked 100 bar chart visualization.

使用 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)

Screenshot of column chart using ysplit axes property.

若要将视图拆分为单独的面板，请指定 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)

Screenshot of column chart using ysplit panels property.