Gráfico de barras

O objeto visual gráfico de barras precisa de, no mínimo, duas colunas no resultado da consulta. Por padrão, a primeira coluna é usada como o eixo y. Essa coluna pode conter tipos de dados texto, datetime ou numéricos. As outras colunas são usadas como o eixo x e contêm tipos de dados numéricos a serem exibidos como linhas horizontais. Os gráficos de barras são usados principalmente para comparar valores numéricos e nominais discretos, em que o comprimento de cada linha representa seu valor.

Observação

Essa visualização só pode ser usada no contexto do operador de renderização.

Syntax

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
T	string	✔️	Nome da tabela de entrada.
propertyName, propertyValue	string		Uma lista separada por vírgulas de pares de propriedades chave-valor. Consulte propriedades com suporte.

Propriedades com suporte

Todas as propriedades são opcionais.

PropertyName	PropertyValue
accumulate	Se o valor de cada medida é adicionado a todos os seus antecessores (true ou false).
kind	Maior elaboração do tipo de visualização. Para obter mais informações, consulte kind property.
legend	Se uma legenda será exibida ou não (visible ou hidden).
series	Lista delimitada por vírgula de colunas cujos valores por registro combinados definem a série à qual o registro pertence.
ymin	O valor mínimo a ser exibido no eixo y.
ymax	O valor máximo a ser exibido no eixo y.
title	O título da visualização (do tipo string).
xaxis	Como dimensionar o eixo x (linear ou log).
xcolumn	Qual coluna no resultado é usada para o eixo x.
xtitle	O título do eixo x (do tipo string).
yaxis	Como dimensionar o eixo y (linear ou log).
ycolumns	Lista delimitada por vírgula de colunas formadas pelos valores fornecidos por valor da coluna x.
ytitle	O título do eixo y (do tipo string).
ysplit	Como dividir a visualização em vários valores de eixo y. Para obter mais informações, consulte ysplit property.

Propriedade ysplit

Essa visualização dá suporte à divisão em vários valores de eixo y:

ysplit	Descrição
none	Um único eixo y é exibido para todos os dados de série. Esse é o padrão.
axes	Um único gráfico é exibido com vários eixos y (um por série).
panels	Um gráfico é renderizado para cada ycolumn valor.

Propriedades com suporte

Todas as propriedades são opcionais.

PropertyName	PropertyValue
kind	Maior elaboração do tipo de visualização. Para obter mais informações, consulte kind property.
series	Lista delimitada por vírgula de colunas cujos valores por registro combinados definem a série à qual o registro pertence.
title	O título da visualização (do tipo string).

Propriedade kind

Essa visualização pode ser ainda mais elaborada fornecendo a kind propriedade . Os valores com suporte dessa propriedade são:

kind valor	Descrição
default	Cada "barra" é independente.
unstacked	Mesmo que default.
stacked	Empilhe as "barras".
stacked100	Empilhe as "barras" e alongue cada uma com a mesma largura que as outras.

Exemplos

Renderizar um gráfico de barras

A consulta a seguir cria um gráfico de barras exibindo o número de eventos de tempestade para cada estado, filtrando apenas os estados com mais de 10 eventos. O gráfico fornece uma representação visual da distribuição de eventos em diferentes estados.

Executar a consulta

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
    )

Renderizar um gráfico de stacked barras

A consulta a seguir cria um stacked gráfico de barras que mostra a contagem total de eventos de tempestade por seu tipo para estados selecionados do Texas, Califórnia e Flórida. Cada barra representa um tipo de evento storm e as barras empilhadas mostram a divisão de eventos de tempestade por estado dentro de cada tipo.

Executar a consulta

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

Renderizar um gráfico de stacked100 barras

A consulta a seguir cria um stacked100 gráfico de barras que mostra a contagem total de eventos de tempestade por seu tipo para estados selecionados do Texas, Califórnia e Flórida. O gráfico mostra a distribuição de eventos de tempestade entre estados dentro de cada tipo. Embora as pilhas somar visualmente até 100, os valores representam realmente o número de eventos, não porcentagens. Essa visualização é útil para entender os percentuais e as contagens de eventos reais.

Executar a consulta

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

Usar a ysplit propriedade

Executar a consulta

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)

Para dividir a exibição em painéis separados, especifique panels em vez de axes:

Executar a consulta

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)