Гистограмма

Визуальному элементу "Гистограмма" требуется как минимум два столбца в результатах запроса. По умолчанию в качестве оси X используется первый столбец. Этот столбец может содержать текст, дату и время или числовые данные. Другие столбцы используются в качестве оси Y и содержат числовые данные, отображаемые в виде вертикальных линий. Гистограммы используются для сравнения конкретных элементов подкатегории в диапазоне основной категории, где длина каждой строки представляет ее значение.

Примечание

Эту визуализацию можно использовать только в контексте оператора render.

Синтаксис

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

Дополнительные сведения о соглашениях о синтаксисе.

Параметры

Имя	Тип	Обязательно	Описание
T	string	✔️	Имя входной таблицы.
propertyName, propertyValue	string		Разделенный запятыми список пар свойств "ключ-значение". См. раздел Поддерживаемые свойства.

Поддерживаемые свойства

Все свойства являются необязательными.

PropertyName	PropertyValue
accumulate	Указывает, добавляется ли значение каждой меры ко всем предшествующим (true или false).
kind	Уточняет тип визуализации. Дополнительные сведения см. в разделеkind свойство .
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 свойство .

Свойствоysplit

Эта визуализация поддерживает разделение на несколько значений оси Y:

ysplit	Описание:
none	Для всех данных ряда отображается отдельная ось Y. Это значение по умолчанию.
axes	Отображается одна диаграмма с несколькими осями Y (по одной на ряд).
panels	Для каждого ycolumn значения отображается одна диаграмма.

Поддерживаемые свойства

Все свойства являются необязательными.

PropertyName	PropertyValue
kind	Уточняет тип визуализации. Дополнительные сведения см. в разделеkind свойство .
series	Разделенный запятыми список столбцов — его объединенные значения отдельных записей определяют ряд, к которому принадлежит запись.
title	Заголовок визуализации (типа string).

Свойствоkind

Эту визуализацию можно дополнительно усовершенствовать, предоставив kind свойство . Поддерживаемые значения этого свойства:

Значение kind	Определение
default	Каждый столбец отображается отдельно.
unstacked	Эквивалентно default.
stacked	Группирует столбцы поверх друг друга.
stacked100	Группирует столбцы и растягивает каждый до высоты других.

Примеры

Отрисовка гистограммы

Выполнить запрос

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

ysplit Использование свойства

Выполнить запрос

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)

Чтобы разделить представление на отдельные панели, укажите panels вместо axes:

Выполнить запрос

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)

Пример

Выполнить запрос

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