Гистограмма
Виджет отображает приближенные вычисления в виде дробного значения количества.
В работе виджета могут быть неточности. Отклонения в конкретных значениях связаны с работой функции, используемой при расчете данных. Подробная информация содержится в документации ClickHouse.
Настройки виджета
Помимо общих настроек, у виджета есть уникальные.
Настройка данных
В виджет можно добавить несколько разрезов, но отображаться будет только первый в списке. Разрез показывает данные только для колонок с типом Integer, Float, Date или DateTime. Для разрезов применимы стандартные настройки. Доступные настройки цвета:
- Авто
- Базовый (цвет выбирается в палитре)
- По правилу (для значений доступны правила с режимом Базовый или Настроить)
- Настроить (по формуле)
Настройка отображения
Помимо общих настроек отображения, для виджета доступны дополнительные.
Размер текста
Регулирует размер текста в строках виджета.
Тип лимита
Доступны следующие типы:
- Числовой
- По переменной
- По формуле
При использовании типа Числовой в параметре Лимит разреза настраивается количество отображаемых на гистограмме значений разреза.
При использовании типа По переменной в раскрывающемся списке можно выбрать любую целочисленную переменную (например, Вводимое значение или Динамический список с типом данных Число). Также на значение переменной и отображение гистограммы в режиме просмотра можно влиять, используя настроенный виджет Параметр.
При использовании типа По формуле указывается формула, регулирующая лимит разреза.
Если значение переменной или формулы больше 50, то на гистограмме отображаются только первые 50 значений.
Лимит разреза
Регулирует количество отображаемых на гистограмме значений разреза.
Подсказка
Если включить подсказку, то в режиме просмотра при наведении на столбик появится окошко с подробной информацией об отображаемых данных, например граничных значениях и точном значении показателя. Также подсказка полезна, если на диаграмме много столбиков и показываются не все подписи под ними.
Тип
Параметр регулирует отображение значений разреза в виде столбиков или линий с точками.
Толщина линий
Параметр доступен, если включено отображение значений разреза в виде линий. Доступны малая или большая толщина.
Сглаживание линий
Переключатель доступен, если включено отображение значений разреза в виде линий, и позволяет сделать их более плавными.
Ориентация
Доступны следующие варианты ориентации:
- Авто
- Вертикальная
- По левому краю
- По правому краю
Ось X
Для оси X можно включить отображение самой оси, заголовка, а также настроить поворот и высоту меток. Название заголовка всегда Формула.
Ось Y
Для оси Y можно включить отображение самой оси, заголовка и указать ширину меток. Название заголовка всегда Количество.
Настройка фильтрации
Для виджета доступны стандартные настройки фильтрации.
Фильтр, настроенный в виджете, невозможно удалить в режиме просмотра.
Режим просмотра
В режиме просмотра виджет работает как фильтр. При клике на столбик вокруг него появляется область выделения. Также изменяются другие виджеты на холсте.
Чтобы выделить несколько значений на гистограмме, зажмите ЛКМ и проведите от первого необходимого столбика до последнего.
К одному или нескольким выделенным значениям можно добавить недостающие. Для этого направьте курсор к границе выделенной области. Иконка курсора изменится на значок с горизонтальными стрелками. Зажмите ЛКМ и проведите до необходимого столбика. Добавление работает, если в настройках фильтрации гистограммы выбран режим Базовый или Единичный выбор.
Выделенную область можно перемещать. Для этого зажмите ЛКМ на области и переместите ее влево или вправо. Столбики не меняют свое положение. Перемещение выделенной области работает, если в настройках фильтрации гистограммы выбран режим Базовый или Единичный выбор.
Добавление значений к выделенным или перемещение области также работает в окне фильтра.
Граничное значение:
- Слева входит в значение интервала, правое граничное значение в значение интервала не входит
- В правую границу входит только для последнего интервала
- У столбика — результат деления всего диапазона данных разреза на отдельные интервалы, поэтому значение из данных разреза может попадать или не попадать на границу диапазона
- Если у столбика в интервале нет ни одного значения, он не отображается на графике
При вычислении гистограммы значения null
, NaN
, -inf
и inf
не учитываются и не отображаются на ее графике.
Настройка виджета в YAML
Виджет можно редактировать не только в визуальном конструкторе, но и в YAML-редакторе. В таблице ниже представлены ключи и значения, которые можно использовать для настройки. Подробнее о том, как работать с ключом value
, описано на странице Значения разрезов и мер в YAML. Форматы данных, которые можно использовать, описаны на соответствующей странице. Общие параметры для виджетов описаны на странице Настройка виджетов в YAML.
Настройки данных в YAML
Ключ | Тип | Определение |
---|---|---|
title | string | Заголовок |
showMarkdown | boolean | Описание |
markdownText | string | Текст описания |
markdownMeasures | — | Меры в описании |
dimensions | — | Разрезы |
Разрезы в YAML (ключ dimensions)
Ключ | Тип | Определение |
---|---|---|
name | string | Название разреза |
value | — | Формула показателя |
dbDataType | enum | Тип данных разреза |
format | enum | Формат |
formatting | enum | Форматирование |
formattingTemplate | string | Собственное форматирование Только для форматирования CUSTOM (Настроить) |
hideEmptyValues | boolean | Скрыть пустые значения |
hierarchyDimensions | — | Разрезы иерархии Если добавлен этот параметр, то показатель определяется как иерархия |
color | — | Цвет: - AUTO — авто- BASE — базовый- FORMULA — по формуле- RULE — по правилуЕсли показатель иерархический, параметр не применяется |
displayCondition | — | Отображать (условие отображения) |
arrayNesting | boolean | Вложенность массива |
Иерархический разрез (ключ hierarchyDimensions)
Ключ | Тип | Определение |
---|---|---|
name | string | Название разреза |
value | — | Формула разреза |
dbDataType | enum | Тип данных разрезза |
format | enum | Формат |
formatting | enum | Форматирование |
formattingTemplate | string | Собственное форматирование Только для форматирования CUSTOM (Настроить) |
hideEmptyValues | boolean | Скрыть пустые значения |
color | — | Цвет: - AUTO — авто- BASE — базовый- FORMULA — по формуле- RULE — по правилу |
displayCondition | — | Отображать (условие отображения) |
arrayNesting | boolean | Вложенность массива |
Настройки отображения в YAML
Ключ | Тип | Определение |
---|---|---|
paddings | string | Отступы по сторонам |
titleSize | number | Размер заголовка |
titleColor | — | Цвет заголовка: - AUTO — авто- BASE — базовый |
titleWeight | enum | Толщина шрифта: - NORMAL — обычная- BOLD — большая |
markdownTextSize | number | Текст описания В параметре указывается размер текста описания в Markdown. Параметр доступен, если активен переключатель Описание |
textSize | number | Размер текста |
binsLimit | number | Лимит разреза |
chartType | enum | Тип: - BAR — столбики- LINE — линии |
orientation | enum | Ориентация: - AUTO — авто- HORIZONTAL — по горизонтали- VERTICAL_LEFT — по левому краю- VERTICAL_RIGHT — по правому краю |
lineThickness | enum | Толщина линий: - THIN — малая- THICK — большаяТолько для типа LINE |
lineSmoothing | boolean | Сглаживание линий Только для типа LINE |
xAxis | — | Настройки оси X |
yAxis | — | Настройки оси Y |
Лимит разреза (ключ binsLimit)
Ключ | Тип | Определение |
---|---|---|
mode | enum | Тип лимита: - NUMBER — числовой- VARIABLE — по переменной- FORMULA — по формуле |
limitValue | number | Значение Только для типа лимита NUMBER |
variable | string | Переменная Только для типа лимита VARIABLE |
formula | string | Формула Только для типа лимита FORMULA |
Настройки оси X (ключ xAxis)
Ключ | Тип | Определение |
---|---|---|
enabled | boolean | Ось X вкл/выкл |
rotation | number | Поворот меток |
height | number | Высота меток |
showTitle | boolean | Заголовок оси X |
Настройки оси Y (ключ yAxis)
Ключ | Тип | Определение |
---|---|---|
enabled | boolean | Ось Y вкл/выкл |
width | number | Ширина меток |
showTitle | boolean | Заголовок оси Y |
Настройки фильтрации в YAML
Ключ | Тип | Определение |
---|---|---|
filterMode | enum | Режим фильтрации: - DEFAULT — базовый- SINGLE — единичный выбор- DISABLED — отключено |
ignoreFilters | boolean | Игнорировать фильтры |
filters | — | Фильтры |
stateName | string | Состояние |
Пример настроенного виджета в YAML-редакторе
widgets:
- key: histogram
apiVersion: "15"
type: HISTOGRAM
settings:
titleColor:
mode: AUTO
titleSize: 14
paddings: 8
titleWeight: NORMAL
textSize: 12
filterMode: DEFAULT
ignoreFilters: false
stateName: null
title: ""
showMarkdown: false
markdownMeasures: []
markdownText: ""
markdownTextSize: 14
xAxis:
enabled: true
showTitle: true
yAxis:
enabled: true
showTitle: true
dimensions:
- name: Формула
value:
mode: FORMULA
formula: toDate("phases"."event_time")
dbDataType: Date
formatting: AUTO
hideEmptyValues: false
format: DATE
displayCondition:
mode: DISABLED
color:
mode: AUTO
binsLimit:
mode: NUMBER
limitValue: 8
variable: Тип лимита по переменной
formula: count("phases"."event_time")
showHint: false
chartType: LINE
orientation: AUTO
lineSmoothing: true
lineThickness: THICK
Была ли статья полезна?