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

# Таблицы (Table)

> Табличные графики для отображения данных в виде строк и колонок

![Пример Table V2 графика](https://mintcdn.com/iyree/qv1iQg_DAyEWpyPw/assets/img/charts/table_v2/table_v2_example.png?fit=max\&auto=format\&n=qv1iQg_DAyEWpyPw\&q=85\&s=2148e8444aa371609c82575e9ebb1a7b)

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

### Поля

**type** `"table_v2"` *required*

Тип графика

**columns** `TableColumn[]` *required*

Определение колонок таблицы. Каждая колонка может быть одного из типов: `dimension`, `dimension_hierarchy`, `dimension_row_grouping`, `measure`.

**Типы колонок**

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

**type** `"dimension"` *required*

Тип колонки

**member** `CubeDimension` *required*

Измерение из куба данных

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

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

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

**Временное измерение (TimeDimension):**

```yaml theme={null}
kind: time
value:
  dimension: sales.created_at
  granularity: month  # second|minute|hour|day|week|month|quarter|year
```

**title** `string`

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

**title\_tooltip** `string`

Подсказка при наведении на заголовок

**column\_width** `number`

Ширина колонки в пикселях

**value\_overflow** `enum`

Обработка длинного текста: `ellipsis` | `break-word`

**conditional\_formatting** `DimensionConditionalFormatting`

Форматирование по значениям измерения

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

**type** `enum` *required*

Тип форматирования: `background` | `text`

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

Цвета для конкретных значений. RGBColor — массив `[R, G, B]` (0-255).

```yaml theme={null}
values:
  "Электроника": [66, 133, 244]
  "Одежда": [251, 188, 4]
  "Продукты": [76, 175, 80]
```

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

Действия при клике на ячейку. Можно использовать только в колонках с типом "measure".

**Структура 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 целевой страницы (для drill\_through)

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

UUID целевого дашборда (для another\_dashboard\_drill\_through)

**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 с подстановкой `{cube.member}`

**open\_in** `enum`

`same_tab` | `new_tab`

**placement** `DataPointActionPlacement`

Позиционирование в меню

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

```yaml theme={null}
placement:
  menu_path: ["Экспорт", "Подменю"]
  group:
    id: "export-group"
    label: "Экспорт"
    order: 1
  order: 1
```

***

### dimension\_hierarchy — Иерархия с drill-down

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

Тип колонки

**title** `string`

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

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

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

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

**member** `CubeDimension` *required*

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

**title** `string`

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

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

***

### dimension\_row\_grouping — Группировка строк

Группирует строки по значениям с возможностью сворачивания.

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

Тип колонки

**title** `string`

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

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

Уровни группировки (структура аналогична dimension\_hierarchy)

> [!NOTE]
>
> **Разница между dimension\_hierarchy и dimension\_row\_grouping:**
>
> * `dimension_hierarchy` — данные подгружаются при раскрытии (lazy loading)
> * `dimension_row_grouping` — все данные загружены сразу, группировка визуальная

***

### measure — Числовой показатель

**type** `"measure"` *required*

Тип колонки

**member** `string` *required*

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

```yaml theme={null}
member: sales.total_revenue
```

**title** `string`

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

**conditional\_formatting** `MeasureConditionalFormatting`

Условное форматирование меры

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

**type** `enum` *required*

Тип: `background` | `text` | `icon`

**filling\_type** `enum` *required*

Способ расчёта: `palette` | `gradient`

**source\_field** `string`

Поле для расчёта (если отличается от текущего)

**conditions** `Condition[]`

Условия для palette

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

**Точное совпадение:**

```yaml theme={null}
type: eq
value: 0
color: [158, 158, 158]
```

**Интервал:**

```yaml theme={null}
type: interval
interval:
  min:
    operator: gte  # gt | gte
    value: 100
  max:
    operator: lt   # lt | lte
    value: 200
  color: [200, 230, 201]
```

**С иконкой (для type: icon):**

```yaml theme={null}
type: interval
interval:
  min:
    operator: gte
    value: 0
  icon:
    library: lucide
    name: trending-up
    color: [76, 175, 80]
```

**gradient** `Gradient`

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

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

**Двухцветный:**

```yaml theme={null}
type: two_colors
palette: white_green  # white_red|white_green|white_blue|white_yellow|white_purple
thresholds:
  min_value: 0
  max_value: 100
```

**Трёхцветный:**

```yaml theme={null}
type: three_colors
palette: red_white_green  # red_yellow_green|red_white_green|green_yellow_red|green_white_red
thresholds:
  min_value: 0
  middle_value: 50
  max_value: 100
```

**position** `enum`

Позиция иконки (для type: icon): `left` | `right` | `icon_only`

**linear\_indicator** `TableMeasureLinearIndicator`

Линейный индикатор (прогресс-бар)

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

**main\_color** `RGBColor` *required*

Основной цвет `[R, G, B]`

**negative\_color** `RGBColor`

Цвет для отрицательных значений

```yaml theme={null}
linear_indicator:
  main_color: [66, 133, 244]
  negative_color: [234, 67, 53]
```

**compare\_formatting\_direction** `enum`

Направление сравнения периодов: `more_better` | `less_better` | `none`

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

Действия при клике (структура описана выше)

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

Включить сравнение с предыдущим периодом

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

Показать строку итогов

**show\_row\_numbers** `boolean` (default: false)

Показать номера строк

**sorting** `TableSorting[]`

Сортировка данных

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

**member** `string` *required*

Имя меры или измерения для сортировки

**direction** `enum` *required*

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

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

### Примеры

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

```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: Выручка
    linear_indicator:
      main_color: [66, 133, 244]
  - type: measure
    member: sales.margin_percent
    title: Маржа %
    conditional_formatting:
      type: background
      filling_type: palette
      conditions:
        - type: interval
          interval:
            min:
              operator: gte
              value: 30
            color: [200, 230, 201]
        - type: interval
          interval:
            max:
              operator: lt
              value: 10
            color: [255, 205, 210]
show_row_numbers: true
include_totals: true
sorting:
  - member: sales.revenue
    direction: desc
```

```yaml С drill-through theme={null}
type: table_v2
columns:
  - type: dimension
    member:
      kind: basic
      value: orders.order_number
    title: Номер заказа
  - type: measure
    member: orders.total
    title: Сумма
	data_point_actions:
      - id: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
        key: "dashboard:drill_through"
        title: "Детали заказа"
        target_page_id: "a1b2c3d4-5678-90ab-cdef-1234567890ab"
        filter_mappings:
          - target_filter_id: "b2c3d4e5-6789-01bc-def0-234567890abc"
            sources:
              - type: data_point_dimension
                member_name: orders.order_id
```

```yaml С форматированием измерений theme={null}
type: table_v2
columns:
  - type: dimension
    member:
      kind: basic
      value: orders.status
    title: Статус
    conditional_formatting:
      type: background
      values:
        "Новый": [227, 242, 253]
        "В работе": [255, 243, 224]
        "Выполнен": [200, 230, 201]
        "Отменён": [255, 205, 210]
  - type: measure
    member: orders.count
    title: Количество
```

***

## См. также

> [card] [Иерархии измерений](../features/dimension-hierarchy)
>
> Drill-down и группировка строк

> [card] [Условное форматирование](../features/conditional-formatting)
>
> Цвета, градиенты, иконки

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

> [card] [Измерения](../features/dimensions)
>
> Типы измерений

***

← [Плитки](https://iyree.mintlify.site/bi/charts/tile.md) | → [Сводные таблицы](./pivot-table)


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