Перейти к основному содержимому

Dimensions (дименшены)

Dimensions. разрезы для группировки и фильтрации метрик. Dimensions можно представить как справочник (словарь маппингов), который определяет, как расшифровывать значения полей для отображения в отчетах по АБ-тестам.

Разрезы (Dimensions) создаются относительно редко, так как один и тот же дименшен можно использовать для множества метрик. Перед созданием убедитесь, что в источнике данных или обогащении присутствует соответствующее поле.

Конфигурация​

# dimensions/dimensions.yaml
dimension_name:
  has_id: true/false # В источниках представлен как <dimension_name>_id
  description: "Описание"
  parent: parent_dim # Опционально: слаг родительского dimension
  slug: short_name # Опционально: сокращенное имя для отображения в отчетах
  is_bool: true/false # Опционально: boolean dimension (не требует SQL-справочника)

Пояснения по полям:

  1. Установите флаг has_id в значение true, если в источниках поле представлено как <dimension_name>_id.
  2. Используйте флаг is_bool, если разрез является булевым и не требует SQL-справочника.
  3. Укажите краткое имя в поле slug для корректного отображения в отчетах.
  4. Применяйте поле parent для настройки иерархических разрезов.

Типы дименшенов​

1. ID-based (has_id: true)​

platform:
  has_id: true
  description: "Платформа (mobile, desktop)"

vertical:
  has_id: true
  parent: null
  description: "Вертикаль"

В source:

SELECT platform_id, vertical_id FROM ...

Для has_id = True должно быть выполнено два требования:

  1. Убедитесь, что тип поля в источнике или обогащении соответствует типу int.
  2. Проверьте, что название поля содержит обязательный суффикс _id.

2. Boolean (is_bool: true)​

is_logged_in:
  is_bool: true
  description: "Авторизованный пользователь"

3. Иерархические (parent)​

vertical:
  has_id: true

logical_category:
  has_id: true
  parent: vertical

category:
  has_id: true
  parent: logical_category

Справочники​

  1. Создавайте справочники для всех дименшенов, кроме тех, где установлен флаг is_bool = True.
  2. Задавайте в справочнике список всех допустимых значений для валидации.
  3. Используйте справочник как источник для расшифровки числовых идентификаторов.

Маппинг ID → значение:

Справочники определяют маппинг между идентификаторами и человекочитаемыми значениями. Например, region_id (это value_id) → region (это value). Это позволяет в отчетах по АБ-тестам отображать понятные названия вместо числовых ID.

-- dimensions/sql/platform.sql
SELECT
  Name as value,                    -- Обязательно: человекочитаемое значение
  Platform_id as value_id,          -- Обязательно для has_id=true: числовой ID
  External_id as value_ext_id       -- Опционально
FROM dds.H_Platform

При подготовке SQL-запроса вы должны переименовать целевые поля в value и value_id. Платформа Trisigma распознает только эти стандартные имена.

Обязательные колонки:

  1. Укажите колонку value, которая обязательна для всех справочников.
  2. Используйте value_id, если для разреза установлен флаг has_id = True.
  3. Добавьте поля parent_dimension, parent_value или parent_value_id для иерархических разрезов.

Опциональные: value_ext_id, is_active

Работа с CLI​

# Список дименшенов \{#spisok-dimenshenov}
trisigma sl list-dimensions

# Валидация \{#validatsiya}
trisigma sl validate

Создание dimension​

1. Добавить в dimensions.yaml​

my_dimension:
  has_id: true
  description: "Описание"

2. Создать SQL​

-- dimensions/sql/my_dimension.sql
SELECT dimension_value as value, dimension_id as value_id
FROM dma.my_dimension_table

3. Добавить колонку в source или enrichments​

-- sources/sql/buyer_stream.sql
SELECT my_dimension_id FROM ...

4. Валидировать​

trisigma sl validate

Best Practices​

Рекомендуется​

  1. Используйте has_id: true для числовых ID
  2. Определяйте иерархии через parent
  3. Добавляйте description

❌ Не рекомендуется​

  1. Dimension без SQL в dimensions/sql/
  2. has_id: true для строковых полей (валидация не пройдет)
  3. Отсутствие description

Следующие шаги​

  1. Изучите практическое руководство в разделе Workflow.
  2. Ознакомьтесь с использованием разрезов в фильтрах в разделе Metrics.

Подробнее: Концепции → Dimensions