> ## 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.

# Иерархии измерений

> Drill-down и группировка строк для навигации по данным

Иерархии измерений позволяют организовать данные в многоуровневую структуру для навигации от общего к частному.

## Типы иерархий

| Тип | Описание | Загрузка данных |
| - | - | - |
| `dimension_hierarchy` | Drill-down (раскрытие уровней) | Lazy (по запросу) |
| `dimension_row_grouping` | Группировка строк | Eager (все сразу) |

***

## Dimension Hierarchy — Drill-down

При клике на значение загружаются данные следующего уровня. Подходит для больших объёмов данных.

### Структура

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

Тип колонки/строки

**title** `string`

Общий заголовок иерархии

**levels** `HierarchyLevel[]` *required*

Уровни иерархии (от верхнего к нижнему)

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

**member** `CubeDimension` *required*

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

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

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

```yaml theme={null}
kind: basic
value: geography.country
```

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

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

**title** `string`

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

### Поддержка в графиках

| График | Где используется |
| - | - |
| Table v2 | `columns` (тип колонки) |
| Pivot Table v2 | `rows` (тип строки) |
| Bar v2 | `main_dimension` |
| Pie | `main_dimension` |

### Примеры

```yaml Таблица с географией theme={null}
type: table_v2
columns:
  - type: dimension_hierarchy
    title: География
    levels:
      - member:
          kind: basic
          value: geography.country
        title: Страна
      - member:
          kind: basic
          value: geography.region
        title: Регион
      - member:
          kind: basic
          value: geography.city
        title: Город
  - type: measure
    member: sales.revenue
    title: Выручка
```

```yaml Сводная таблица с иерархией theme={null}
type: pivot_table_v2
columns:
  - member:
      kind: time
      value:
        dimension: sales.created_at
        granularity: quarter
    title: Квартал
rows:
  - type: dimension_hierarchy
    title: Расположение
    levels:
      - member:
          kind: basic
          value: stores.region
        title: Регион
      - member:
          kind: basic
          value: stores.city
        title: Город
      - member:
          kind: basic
          value: stores.name
        title: Магазин
measures:
  - member: sales.revenue
    title: Выручка
```

```yaml Столбчатая диаграмма с drill-down theme={null}
type: bar_v2
main_dimension:
  type: dimension_hierarchy
  levels:
    - member:
        kind: basic
        value: products.category
      title: Категория
    - member:
        kind: basic
        value: products.subcategory
      title: Подкатегория
    - member:
        kind: basic
        value: products.name
      title: Товар
main_measure:
  measure: sales.revenue
  title: Выручка
```

```yaml Круговая диаграмма с иерархией theme={null}
type: pie
pie_type: donut
main_dimension:
  type: dimension_hierarchy
  levels:
    - member:
        kind: basic
        value: geography.region
      title: Регион
    - member:
        kind: basic
        value: geography.city
      title: Город
main_measure:
  measure: sales.revenue
  title: Выручка
```

***

## Dimension Row Grouping — Группировка строк

Все данные загружаются сразу, строки визуально группируются с возможностью сворачивания.

> [!NOTE]
>
> Используйте `dimension_row_grouping`, когда объём данных невелик и нужна визуальная группировка без дополнительных запросов к серверу.

### Структура

**type** `"dimension_row_grouping"` *required*

Тип колонки/строки

**title** `string`

Заголовок колонки

**levels** `HierarchyLevel[]` *required*

Уровни группировки (структура аналогична `dimension_hierarchy`)

### Поддержка в графиках

| График | Где используется |
| - | - |
| Table v2 | `columns` (тип колонки) |
| Pivot Table v2 | `rows` (тип строки) |

### Примеры

```yaml Таблица с группировкой theme={null}
type: table_v2
columns:
  - type: dimension_row_grouping
    title: Категория / Подкатегория
    levels:
      - member:
          kind: basic
          value: products.category
        title: Категория
      - member:
          kind: basic
          value: products.subcategory
        title: Подкатегория
  - type: dimension
    member:
      kind: basic
      value: products.name
    title: Товар
  - type: measure
    member: sales.revenue
    title: Выручка
  - type: measure
    member: sales.quantity
    title: Количество
include_totals: true
```

```yaml Сводная таблица с группировкой theme={null}
type: pivot_table_v2
columns:
  - member:
      kind: time
      value:
        dimension: sales.created_at
        granularity: month
    title: Месяц
rows:
  - type: dimension_row_grouping
    title: Категория
    levels:
      - member:
          kind: basic
          value: products.category
        title: Категория
      - member:
          kind: basic
          value: products.subcategory
        title: Подкатегория
measures:
  - member: sales.revenue
    title: Выручка
include_rows_totals: true
```

***

## Сравнение типов

| Характеристика | dimension\_hierarchy | dimension\_row\_grouping |
| - | - | - |
| Загрузка данных | По запросу (lazy) | Сразу (eager) |
| Производительность | Лучше для больших данных | Лучше для малых данных |
| Взаимодействие | Клик для раскрытия | Клик для сворачивания/разворачивания |
| Визуальная группировка | Нет | Да |
| Поддержка в Bar/Pie | ✅ | ❌ |

***

## Рекомендации

**1. Оцените объём данных**

* Меньше 1000 строк → `dimension_row_grouping`
* Больше 1000 строк → `dimension_hierarchy`

**2. Определите глубину иерархии**

Оптимально 2-4 уровня. Больше 4 уровней усложняет навигацию.

**3. Логический порядок**

Уровни должны идти от общего к частному: Страна → Регион → Город

> [!WARNING]
>
> Избегайте глубоких иерархий с `dimension_row_grouping` — это приведёт к загрузке большого объёма данных.

***

## См. также

> [card] [Измерения](https://iyree.mintlify.site/bi/charts/features/dimensions.md)
>
> Типы измерений

> [card] [Таблицы](../charts/table)
>
> Использование в таблицах

> [card] [Сводные таблицы](../charts/pivot-table)
>
> Использование в сводных таблицах

> [card] [Столбчатые диаграммы](../charts/bar)
>
> Drill-down в диаграммах

***

← [Измерения](https://iyree.mintlify.site/bi/charts/features/dimensions.md) | → [Действия с данными](https://iyree.mintlify.site/bi/charts/features/data-point-actions.md)


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