Histogramme

Le visuel d’histogramme a besoin d’au moins deux colonnes dans le résultat de la requête. Par défaut, la première colonne est utilisée pour l’axe des abscisses (x). Cette colonne peut contenir des types de données textuels, DateHeure ou numériques. Les autres colonnes sont utilisées pour l’axe des ordonnées (y) et contiennent des types de données numériques à afficher sous forme de lignes verticales. Les histogrammes permettent de comparer des éléments de sous-catégories spécifiques dans une plage de catégorie principale, la longueur de chaque ligne représentant sa valeur.

Notes

Cette visualisation ne peut être utilisée que dans le contexte de l’opérateur de rendu.

Syntax

T|rendercolumnchart [with(propertyName=, propriétéValue [, ...])]

Découvrez les conventions de syntaxe.

Paramètres

Nom	Type	Obligatoire	Description
T	string	✔️	Nom de la table d’entrée.
propertyName, propertyValue	string		Liste séparée par des virgules de paires de propriétés clé-valeur. Consultez propriétés prises en charge.

Propriétés prises en charge

Toutes les propriétés sont facultatives.

PropertyName	PropertyValue
accumulate	Indique si la valeur de chaque mesure est ajoutée à tous ses prédécesseurs. (true ou false)
kind	Élaboration plus poussée du type de visualisation. Pour plus d’informations, consultez kind propriété.
legend	Indique s’il faut afficher une légende ou non (visible ou hidden).
series	Liste de colonnes (délimitées par des virgules) dont les valeurs par enregistrement combinées définissent la série à laquelle l’enregistrement appartient.
ymin	Valeur minimale à afficher sur l’axe y.
ymax	Valeur maximale à afficher sur l’axe y.
title	Titre de la visualisation (de type string).
xaxis	Comment mettre à l’échelle l’axe x (linear ou log).
xcolumn	Quelle colonne dans le résultat est utilisée pour l’axe x.
xtitle	Titre de l’axe x (de type string).
yaxis	Comment mettre à l’échelle l’axe y (linear ou log).
ycolumns	Liste de colonnes séparées par des virgules qui se composent des valeurs fournies par valeur de la colonne x.
ytitle	Titre de l’axe y (de type string).
ysplit	Comment fractionner la visualisation en plusieurs valeurs d’axe y. Pour plus d’informations, consultez ysplit propriété.

Propriété ysplit

Cette visualisation prend en charge le fractionnement en plusieurs valeurs d’axe y :

ysplit	Description
none	Un seul axe y est affiché pour toutes les données de la série. Il s’agit de la valeur par défaut.
axes	Un graphique unique s’affiche avec plusieurs axes y (un par série).
panels	Un graphique est affiché pour chaque ycolumn valeur.

Propriétés prises en charge

Toutes les propriétés sont facultatives.

PropertyName	PropertyValue
kind	Élaboration plus poussée du type de visualisation. Pour plus d’informations, consultez kind propriété.
series	Liste de colonnes (délimitées par des virgules) dont les valeurs par enregistrement combinées définissent la série à laquelle l’enregistrement appartient.
title	Titre de la visualisation (de type string).

Propriété kind

Cette visualisation peut être développée davantage en fournissant la kind propriété . Les valeurs prises en charge de cette propriété sont les suivantes :

Valeur kind	Définition
default	Chaque « colonne » est autonome.
unstacked	Comme pour default.
stacked	Empilez les « colonnes » les unes sur les autres.
stacked100	Empilez les « colonnes » et étendez chacune d’elles à la même hauteur que les autres.

Exemples

Rendu d’un histogramme

Exécuter la requête

StormEvents
| summarize event_count=count() by State
| where event_count > 10
| project State, event_count
| render columnchart

Utiliser la ysplit propriété

Exécuter la requête

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

Pour fractionner la vue en panneaux distincts, spécifiez panels au lieu de axes:

Exécuter la requête

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

Exemple

Exécuter la requête

StormEvents
| summarize event_count=count() by State
| where event_count > 10
| project State, event_count
| render columnchart