> ## Documentation Index
> Fetch the complete documentation index at: https://iyree.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Столбчатые диаграммы (Bar)

> Столбчатые диаграммы для сравнения значений по категориям

![Пример Bar V2 графика](https://mintcdn.com/iyree/k8VfyfyiOthBr5L4/assets/img/charts/bar_v2/bar_v2_example.png?fit=max\&auto=format\&n=k8VfyfyiOthBr5L4\&q=85\&s=b3614fd8a519929a20391cb828a5239c)

Диаграмма с поддержкой стеков, иерархий, выбираемых полей и гибких настроек отображения.

### Поля

**type** `"bar_v2"` *required*

Тип графика

**direction** `enum` (default: vertical)

Ориентация столбцов

**Значения**

| Значение | Описание |
| - | - |
| `vertical` | Вертикальные столбцы (категории по оси X) |
| `horizontal` | Горизонтальные столбцы (категории по оси Y) |

**main\_measure** `BarMeasure`

Основная мера. Используйте либо `main_measure`, либо `selectable_main_measure`.

**Структура BarMeasure**

**measure** `string` *required*

Имя меры из куба

**title** `string`

Заголовок (отображается в легенде и тултипе)

**color** `string`

HEX-цвет столбца

```yaml theme={null}
color: "#3B82F6"
```

**data\_point\_actions** `DataPointActionDefinition[]`

Действия при клике на столбец

**Структура DataPointActionDefinition**

**id** `string` *required*

UUID действия

**key** `string` *required*

Ключ: `common:copy_value` | `common:view_raw_data` | `link:open` | `dashboard:drill_through` | `dashboard:another_dashboard_drill_through`

**title** `string` *required*

Текст в меню

**icon** `IconReference`

Иконка: `{library: "lucide", name: "icon-name", color?: [R,G,B]}`

**target\_page\_id** `string`

UUID целевой страницы

**target\_dashboard\_id** `string`

UUID целевого дашборда

**filter\_mappings** `DrillThroughFilterMapping[]`

Маппинг фильтров

**Структура**

```yaml theme={null}
filter_mappings:
  - target_filter_id: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    sources:
      - type: data_point_dimension
        member_name: products.category
```

**url** `string`

URL для link:open

**open\_in** `enum`

`same_tab` | `new_tab`

```yaml theme={null}
main_measure:
  measure: sales.revenue
  title: Выручка
  color: "#3B82F6"
```

**selectable\_main\_measure** `SelectableMeasureField`

Выбираемая основная мера

**Структура SelectableMeasureField**

**type** `"single"` *required*

Тип выбора (для основной меры — всегда single)

**hint** `string`

Подсказка для пользователя

**options** `BarMeasure[]` *required*

Варианты мер (структура BarMeasure описана выше)

```yaml theme={null}
selectable_main_measure:
  type: single
  hint: Выберите показатель
  options:
    - measure: sales.revenue
      title: Выручка
    - measure: sales.quantity
      title: Количество
```

**main\_dimension** `BarDimension`

Основное измерение (категории). Используйте либо `main_dimension`, либо `selectable_main_dimension`.

**Типы BarDimension**

### Простое измерение

**type** `"dimension"` (default: dimension)

Тип

**dimension** `CubeDimension` *required*

Измерение из куба

**Структура CubeDimension**

**Обычное измерение:**

```yaml theme={null}
kind: basic
value: products.category
```

**Временное измерение:**

```yaml theme={null}
kind: time
value:
  dimension: sales.created_at
  granularity: month
```

**title** `string`

Заголовок

**colors** `BarDimensionColors`

Цвета для значений измерения

**Структура BarDimensionColors**

**palette\_name** `string`

Имя цветовой палитры

**values** `Dict[string, string]`

HEX-цвета для конкретных значений

```yaml theme={null}
colors:
  palette_name: custom
  values:
    "Электроника": "#3B82F6"
    "Одежда": "#10B981"
    "Продукты": "#F59E0B"
```

***

### Иерархия измерений (drill-down)

**type** `"dimension_hierarchy"` *required*

Тип

**levels** `BarHierarchyLevel[]` *required*

Уровни иерархии

**Структура BarHierarchyLevel**

**member** `CubeDimension` *required*

Измерение уровня

**title** `string`

Заголовок уровня

**colors** `BarDimensionColors`

Цвета для уровня

```yaml theme={null}
levels:
  - member:
      kind: basic
      value: geography.country
    title: Страна
  - member:
      kind: basic
      value: geography.city
    title: Город
```

```yaml theme={null}
main_dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория
```

**selectable\_main\_dimension** `SelectableDimensionField`

Выбираемое основное измерение

**Структура**

```yaml theme={null}
selectable_main_dimension:
  type: single
  hint: Выберите разрез
  options:
    - dimension:
        kind: basic
        value: products.category
      title: По категориям
    - dimension:
        kind: basic
        value: managers.name
      title: По менеджерам
```

**additional\_measures** `BarMeasure[]`

Дополнительные меры (отображаются как дополнительные столбцы). Используйте либо `additional_measures`, либо `selectable_additional_measures`.

```yaml theme={null}
additional_measures:
  - measure: sales.quantity
    title: Количество
    color: "#10B981"
  - measure: sales.margin
    title: Маржа
    color: "#F59E0B"
```

**selectable\_additional\_measures** `SelectableMeasureField`

Выбираемые дополнительные меры

**Структура**

```yaml theme={null}
selectable_additional_measures:
  type: multiple
  hint: Дополнительные показатели
  options:
    - measure: sales.quantity
      title: Количество
      selected: false
    - measure: sales.margin
      title: Маржа
      selected: true
```

**additional\_dimension** `BarDimension`

Дополнительное измерение для разбивки (создаёт стековую диаграмму). Используйте либо `additional_dimension`, либо `selectable_additional_dimension`.

```yaml theme={null}
additional_dimension:
  dimension:
    kind: basic
    value: products.brand
  title: Бренд
  colors:
    palette_name: brands
```

**selectable\_additional\_dimension** `SelectableDimensionField`

Выбираемое дополнительное измерение

**options** `BarV2Options`

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

**Структура BarV2Options**

**dim\_axis** `DimAxisOptions`

Ось измерений (X для вертикальных, Y для горизонтальных)

**Структура**

**show\_title** `boolean` (default: true)

Показать заголовок оси

**show\_labels** `boolean` (default: true)

Показать подписи

**show\_grid** `boolean` (default: true)

Показать сетку

**show\_zoom** `boolean` (default: true)

Показать зум

**rotate\_if\_not\_fit\_one\_line** `boolean` (default: false)

Поворачивать подписи, если не помещаются

**value\_bar\_axis** `ValueAxisOptions`

Ось значений для столбцов

**Структура**

**show\_title** `boolean` (default: true)

Показать заголовок оси

**show\_labels** `boolean` (default: true)

Показать подписи

**show\_grid** `boolean` (default: true)

Показать сетку

**show\_values** `boolean` (default: true)

Показать значения на столбцах

**values\_position** `enum` (default: inside)

Позиция значений: `inside` | `outside`

**hide\_overlapping\_values** `boolean` (default: true)

Скрывать перекрывающиеся значения

**value\_line\_axis** `ValueAxisOptions`

Ось значений для линий (если есть)

**legend** `LegendOptions`

Настройки легенды

**Структура**

**show** `boolean` (default: true)

Показать легенду

**stack\_dimensions** `boolean` (default: false)

Стекировать по дополнительному измерению

```yaml theme={null}
options:
  dim_axis:
    show_labels: true
    rotate_if_not_fit_one_line: true
  value_bar_axis:
    show_values: true
    values_position: outside
  legend:
    show: true
  stack_dimensions: true
```

**sorting** `BarSorting[]`

Сортировка

**Структура BarSorting**

**member** `string` *required*

Имя меры или измерения

**direction** `enum` *required*

Направление: `asc` | `desc`

```yaml theme={null}
sorting:
  - member: sales.revenue
    direction: desc
```

**show\_totals** `boolean` (default: false)

Показать общий итог

**show\_main\_dim\_totals** `boolean` (default: false)

Показать итоги по основному измерению

**compare\_period\_enabled** `boolean` (default: false)

Сравнение периодов

### Примеры

```yaml Простая вертикальная theme={null}
type: bar_v2
direction: vertical
main_dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория
main_measure:
  measure: sales.revenue
  title: Выручка
  color: "#3B82F6"
```

```yaml Горизонтальная с сортировкой theme={null}
type: bar_v2
direction: horizontal
main_dimension:
  dimension:
    kind: basic
    value: managers.name
  title: Менеджер
main_measure:
  measure: sales.revenue
  title: Выручка
sorting:
  - member: sales.revenue
    direction: desc
options:
  value_bar_axis:
    show_values: true
    values_position: outside
```

```yaml Стековая диаграмма theme={null}
type: bar_v2
direction: vertical
main_dimension:
  dimension:
    kind: time
    value:
      dimension: sales.created_at
      granularity: month
  title: Месяц
main_measure:
  measure: sales.revenue
  title: Выручка
additional_dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория
  colors:
    palette_name: categories
options:
  stack_dimensions: true
  legend:
    show: true
```

```yaml С иерархией (drill-down) theme={null}
type: bar_v2
direction: vertical
main_dimension:
  type: dimension_hierarchy
  levels:
    - member:
        kind: basic
        value: geography.country
      title: Страна
    - member:
        kind: basic
        value: geography.region
      title: Регион
    - member:
        kind: basic
        value: geography.city
      title: Город
main_measure:
  measure: sales.revenue
  title: Выручка
  data_point_actions:
    - id: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      key: "common:copy_value"
      title: "Копировать значение"
```

```yaml С выбираемыми полями theme={null}
type: bar_v2
direction: vertical

selectable_main_dimension:
  type: single
  hint: Разрез
  options:
    - dimension:
        kind: basic
        value: products.category
      title: По категориям
    - dimension:
        kind: basic
        value: managers.name
      title: По менеджерам

selectable_main_measure:
  type: single
  hint: Показатель
  options:
    - measure: sales.revenue
      title: Выручка
    - measure: sales.quantity
      title: Количество

selectable_additional_measures:
  type: multiple
  hint: Дополнительно
  options:
    - measure: sales.margin
      title: Маржа
      selected: false
    - measure: sales.average_check
      title: Средний чек
      selected: false

show_totals: true
```

***

## См. также

> [card] [Иерархии измерений](../features/dimension-hierarchy)
>
> Drill-down в диаграммах

> [card] [Действия с данными](../features/data-point-actions)
>
> Клики и drill-through

> [card] [Выбираемые поля](../features/selectable-fields)
>
> Динамический выбор

> [card] [Сортировка](../features/sorting)
>
> Настройка порядка

***

← [Сводные таблицы](./pivot-table) | → [Круговые диаграммы](https://iyree.mintlify.site/bi/charts/pie.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.