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

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

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

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

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

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

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

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

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

Структура документа

Основы

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

Инструменты

  1. Используйте Trisigma CLI для выполнения валидации и генерации SQL-кода.
  2. Просматривайте доступные показатели в Реестре метрик.

Частота обновления данных

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

Решение проблем при настройке

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

  2. Применяйте Trisigma CLI для локальной отладки конфигураций.

    trisigma sl validate

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