Compartilhar via


Gráfico de barras

Aplica-se a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

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.

Sintaxe

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória 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 as propriedades suportadas.

Propriedades aceitas

Todas as propriedades são opcionais.

PropertyName PropertyValue
accumulate Se o valor de cada medida é adicionado a todos os seus predecessores (true ou false).
kind Maior elaboração do tipo de visualização. Para obter mais informações, consulte kind propriedade.
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 do eixo y. Para obter mais informações, consulte ysplit propriedade.

Propriedade ysplit

Essa visualização dá suporte à divisão em vários valores do 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 aceitas

Todas as propriedades são opcionais.

PropertyName PropertyValue
kind Maior elaboração do tipo de visualização. Para obter mais informações, consulte kind propriedade.
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 elaborada ainda mais 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.

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
    )

Captura de tela de um gráfico de barras rotulado.

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 tipo para estados selecionados do Texas, Califórnia e Flórida. Cada barra representa um tipo de evento de tempestade e as barras empilhadas mostram o detalhamento dos eventos de tempestade por estado dentro de cada tipo.

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 de uma visualização de gráfico de barras empilhadas.

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 tipo para estados selecionados do Texas, Califórnia e Flórida. O gráfico mostra a distribuição de eventos de tempestade entre os estados dentro de cada tipo. Embora as pilhas somem visualmente 100, os valores realmente representam o número de eventos, não porcentagens. Essa visualização é útil para entender as porcentagens e as contagens reais de eventos.

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

Captura de tela de uma visualização de gráfico de 100 barras empilhadas.

Use a ysplit propriedade

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)

Captura de tela do gráfico de colunas usando a propriedade ysplit axes.

Para dividir a vista em painéis separados, especifique panels em vez de 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)

Captura de tela do gráfico de colunas usando a propriedade ysplit panels.