Grafico a barre

L'oggetto visivo grafico a barre richiede almeno due colonne nel risultato della query. Per impostazione predefinita, la prima colonna viene usata come asse y. Questa colonna può contenere tipi di dati text, datetime o numerici. Le altre colonne vengono utilizzate come asse x e contengono tipi di dati numerici da visualizzare come linee orizzontali. I grafici a barre vengono usati principalmente per confrontare valori discreti numerici e nominale, in cui la lunghezza di ogni riga rappresenta il relativo valore.

Nota

Questa visualizzazione può essere usata solo nel contesto dell'operatore di rendering.

Sintassi

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

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Tipo Obbligatoria Descrizione
T string ✔️ Nome tabella di input.
propertyName, propertyValue string Elenco delimitato da virgole di coppie di proprietà chiave-valore. Vedere le proprietà supportate.

Proprietà supportate

Tutte le proprietà sono facoltative.

PropertyName PropertyValue
accumulate Indica se il valore di ogni misura viene aggiunto a tutti i predecessori (true o false).
kind Ulteriore elaborazione del tipo di visualizzazione. Per altre informazioni, vedere kind proprietà.
legend Indica se visualizzare o meno una legenda (visible o hidden).
series Elenco delimitato da virgole di colonne i cui valori per record combinati definiscono la serie a cui appartiene il record.
ymin Valore minimo da visualizzare sull'asse y.
ymax Valore massimo da visualizzare sull'asse y.
title Titolo della visualizzazione (di tipo string).
xaxis Indica la scala da applicare all'asse x (linear o log).
xcolumn Indica quale colonna del risultato viene usata per l'asse x.
xtitle Titolo dell'asse x (di tipo string).
yaxis Indica la scala da applicare all'asse y (linear o log).
ycolumns Elenco delimitato da virgole di colonne costituite dai valori specificati in base al valore della colonna x.
ytitle Titolo dell'asse y (di tipo string).
ysplit Come suddividere la visualizzazione in più valori dell'asse y. Per altre informazioni, vedere ysplit proprietà.

Proprietàysplit

Questa visualizzazione supporta la suddivisione in più valori dell'asse y:

ysplit Descrizione
none Viene visualizzato un solo asse y per tutti i dati della serie. Questo è il valore predefinito.
axes Viene visualizzato un singolo grafico con più assi y (uno per serie).
panels Viene eseguito il rendering di un grafico per ogni ycolumn valore.

Proprietà supportate

Tutte le proprietà sono facoltative.

PropertyName PropertyValue
kind Ulteriore elaborazione del tipo di visualizzazione. Per altre informazioni, vedere kind proprietà.
series Elenco delimitato da virgole di colonne i cui valori per record combinati definiscono la serie a cui appartiene il record.
title Titolo della visualizzazione (di tipo string).

Proprietàkind

Questa visualizzazione può essere ulteriormente elaborata fornendo la kind proprietà . I valori supportati di questa proprietà sono:

Valore della proprietà kind Descrizione
default Ogni "barra" è a sé stante.
unstacked Uguale a default.
stacked Impila le "barre".
stacked100 Impilare le "barre" e estenderne ognuna alla stessa larghezza delle altre.

Esempio

Eseguire il rendering di un grafico a barre

La query seguente crea un grafico a barre che visualizza il numero di eventi storm per ogni stato, filtrando solo gli stati con più di 10 eventi. Il grafico fornisce una rappresentazione visiva della distribuzione degli eventi tra stati diversi.

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 di un grafico a barre con etichetta.

Eseguire il rendering di un stacked grafico a barre

La query seguente crea un stacked grafico a barre che mostra il numero totale di eventi storm in base al tipo per gli stati selezionati di Texas, California e Florida. Ogni barra rappresenta un tipo di evento storm e le barre in pila mostrano la suddivisione degli eventi storm in base allo stato all'interno di ogni 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 di una visualizzazione grafico a barre in pila.

Eseguire il rendering di un stacked100 grafico a barre

La query seguente crea un stacked100 grafico a barre che mostra il numero totale di eventi storm in base al tipo per gli stati selezionati di Texas, California e Florida. Il grafico mostra la distribuzione degli eventi storm tra stati all'interno di ogni tipo. Anche se gli stack sommano visivamente fino a 100, i valori rappresentano effettivamente il numero di eventi, non le percentuali. Questa visualizzazione è utile per comprendere sia le percentuali che i conteggi effettivi degli eventi.

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 di una visualizzazione del grafico a 100 barre in pila.

Usare la ysplit proprietà

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 dell'istogramma che usa la proprietà assi ysplit.

Per suddividere la visualizzazione in pannelli separati, specificare panels invece di 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 dell'istogramma che usa la proprietà pannelli ysplit.