Перейти к содержанию

Семантический слой#

Семантический слой — это система описания бизнес-логики расчета метрик. Описываете метрики в YAML, платформа генерирует оптимизированный SQL.

Зачем это нужно?#

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

Без семантического слоя:

  • Два человека могут посчитать одну и ту же метрику по-разному
  • Нет единого источника истины для определения метрик
  • Сложно поддерживать согласованность расчетов

С семантическим слоем:

  • Стандартизированная процедура заведения метрик
  • Декларативное описание логики расчета в YAML
  • Автоматическая генерация SQL с оптимизациями
  • Единая точка определения метрик для всей компании

Репозиторий#

Семантический слой настраивается в репозитории:

Структура документации#

Основы#

  1. Основные концепции — структура репозитория и связи между компонентами
  2. Sources — извлечение данных из DWH
  3. Enrichments — автоматическое обогащение через LEFT JOIN и вычисляемые поля
  4. Metrics — логика расчета метрик (counter, uniq, ratio)
  5. Dimensions — разрезы для группировки

Инструменты#

Часто задаваемые вопросы (FAQ)#

Как часто обновляются данные по метрикам?#

Данные отчетов обновляются раз в 24 часа.

Что делать, если при заведении метрики произошла ошибка?#

  1. Внимательно прочитайте текст ошибки — часто он содержит точное указание на проблему

  2. Используйте Trisigma CLI:

    trisigma sl validate

# С объяснением от AI
trisigma sl validate --ai-explain

  3. Обратитесь за помощью:

    • Trisigma Support Channel — общие вопросы
    • Trisigma Team Channel — вопросы по метрикам