Гистограмма

В этой статье

Гистограмма

Виджет отображает приближенные вычисления в виде дробного значения количества.

Предупреждение

В работе виджета могут быть неточности. Отклонения в конкретных значениях связаны с работой функции, используемой при расчете данных. Подробная информация содержится в документации ClickHouse.

Настройки виджета

Помимо общих настроек, у виджета есть уникальные.

Настройка данных

В виджет можно добавить несколько разрезов. Разрез показывает данные только для колонок с типом Integer, Float, Date и DateTime. Для разрезов применимы стандартные настройки. Доступные настройки цвета:

Авто
Базовый (цвет выбирается в палитре)
По правилу (для значений доступны правила с режимом Базовый или Настроить)
Настроить (по формуле)

Настройка отображения

Помимо общих настроек отображения, для виджета доступны дополнительные.

Размер текста

Регулирует размер текста в строках виджета (по умолчанию — 12).

Лимит столбцов

Регулирует количество отображаемых на гистограмме столбиков (по умолчанию — 8).

Подсказка

Если включить подсказку, то в режиме просмотра при наведении на столбик появится окошко с подробной информацией об отображаемых данных, например граничных значениях и точном значении показателя. Также подсказка полезна, если на диаграмме много столбиков и показываются не все подписи под ними.

Ось 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	—	Отображать (условие отображения)

Иерархический разрез (ключ hierarchyDimensions)

Ключ	Тип	Определение
name	string	Название разреза
value	—	Формула разреза
dbDataType	enum	Тип данных разрезза
format	enum	Формат
formatting	enum	Форматирование
formattingTemplate	string	Собственное форматирование Только для форматирования `CUSTOM` (Настроить)
hideEmptyValues	boolean	Скрыть пустые значения
color	—	Цвет: - `AUTO` — авто - `BASE` — базовый - `FORMULA` — по формуле - `RULE` — по правилу
displayCondition	—	Отображать (условие отображения)

Настройки отображения в YAML

Ключ	Тип	Определение
appearance	—	Расширенные настройки отображения
titleSize	number	Размер заголовка
titleColor	—	Цвет заголовка: - `AUTO` — авто - `BASE` — базовый
titleWeight	enum	Толщина шрифта: - `NORMAL` — обычная - `BOLD` — большая
textSize	number	Размер текста
binsLimit	number	Лимит столбцов
xAxis	—	Настройки оси X
yAxis	—	Настройки оси Y

Настройки оси X (ключ xAxis)

Ключ	Тип	Определение
enabled	boolean	Ось X вкл/выкл
rotation	number	Поворот меток
height	number	Высота меток
showTitle	boolean	Заголовок

Настройки оси Y (ключ yAxis)

Ключ	Тип	Определение
enabled	boolean	Ось Y вкл/выкл
width	number	Ширина меток

Настройки фильтрации в YAML

Ключ	Тип	Определение
filterMode	enum	Режим фильтрации: - `DEFAULT` — базовый - `SINGLE` — единичный выбор - `MULTI` — множественный выбор - `DISABLED` — отключено
ignoreFilters	boolean	Игнорировать фильтры
filters	—	Фильтры
stateName	string	Состояние

Пример настроенного виджета в YAML-редакторе

- key: HISTOGRAM
  apiVersion: "7"
  type: HISTOGRAM
  settings:
    displayCondition:
      mode: DISABLED
    textSize: 12
    xAxis:
      showTitle: false
      enabled: true
    ignoreFilters: false
    filterMode: DEFAULT
    yAxis:
      showTitle: false
      enabled: true
    sorting: []
    dimensions:
      - displayCondition:
          mode: DISABLED
        color:
          mode: BASE
        formattingTemplate: ""
        dbDataType: FLOAT
        name: Себестоимость
        format: NUMBER
        value:
          mode: FORMULA
          formula: '"sale"."Себестоимость"'
        formatting: "#,##x"
    title: ""
    titleSize: 14
    stateName: Состояние 1
    binsLimit: 8
    titleColor:
      mode: AUTO
    titleWeight: NORMAL
    showMarkdown: false
    markdownMeasures: []
    markdownText: ""

Была ли статья полезна?

Да

Нет

Кольцевая диаграмма

Показатель