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

# Измерения (Dimensions)

> Типы измерений для группировки данных

Измерения определяют, как данные группируются и агрегируются в графиках.

## Типы измерений

| Тип | `kind` | Описание |
| - | - | - |
| Обычное | `basic` | Категориальное измерение |
| Временное | `time` | Временное измерение с гранулярностью |

***

## BasicDimension — Обычное измерение

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

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

**kind** `"basic"` *required*

Тип измерения

**value** `string` *required*

Полное имя измерения в формате `cube_name.dimension_name`

### Пример

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

### Применение

```yaml theme={null}
# В таблице
columns:
  - type: dimension
    member:
      kind: basic
      value: products.category
    title: Категория

# В столбчатой диаграмме
main_dimension:
  dimension:
    kind: basic
    value: managers.name
  title: Менеджер
```

***

## TimeDimension — Временное измерение

Временное измерение с настраиваемой гранулярностью для анализа по периодам.

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

**kind** `"time"` *required*

Тип измерения

**value** `TimeDimensionValue` *required*

Настройки временного измерения

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

**dimension** `string` *required*

Полное имя временного измерения из куба

**granularity** `enum` *required*

Гранулярность агрегации

| Значение | Описание | Пример |
| - | - | - |
| `second` | Секунды | 2024-01-15 10:30:45 |
| `minute` | Минуты | 2024-01-15 10:30 |
| `hour` | Часы | 2024-01-15 10:00 |
| `day` | Дни | 2024-01-15 |
| `week` | Недели | 2024-W03 |
| `month` | Месяцы | 2024-01 |
| `quarter` | Кварталы | 2024-Q1 |
| `year` | Годы | 2024 |

### Пример

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

### Применение

```yaml theme={null}
# В сводной таблице — колонки по месяцам
columns:
  - member:
      kind: time
      value:
        dimension: sales.created_at
        granularity: month
    title: Месяц

# В столбчатой диаграмме — тренд по дням
main_dimension:
  dimension:
    kind: time
    value:
      dimension: orders.created_at
      granularity: day
  title: Дата

# Для тренд-линии в плитке
trendline:
  time_dimension:
    dimension: sales.created_at
    granularity: day
```

***

## Выбор гранулярности

> [!NOTE]
>
> Выбирайте гранулярность в зависимости от объёма данных и требуемой детализации.

| Период данных | Рекомендуемая гранулярность |
| - | - |
| 1-7 дней | `hour` или `day` |
| 1-4 недели | `day` |
| 1-6 месяцев | `day` или `week` |
| 6-12 месяцев | `week` или `month` |
| 1-3 года | `month` или `quarter` |
| 3+ года | `quarter` или `year` |

***

## Примеры использования

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

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

```yaml Тренд по неделям theme={null}
type: bar_v2
main_dimension:
  dimension:
    kind: time
    value:
      dimension: orders.created_at
      granularity: week
  title: Неделя
main_measure:
  measure: orders.count
  title: Заказы
```

***

## См. также

> [card] [Иерархии измерений](https://iyree.mintlify.site/bi/charts/features/dimension-hierarchy.md)
>
> Drill-down и группировка

> [card] [Базовые типы](https://iyree.mintlify.site/bi/charts/reference/types.md)
>
> CubeDimension и другие типы

***

← [Функциональность](https://iyree.mintlify.site/bi/charts/features/index.md) | → [Иерархии измерений](https://iyree.mintlify.site/bi/charts/features/dimension-hierarchy.md)


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