Простые метрики
Простые метрики — это метрики, которые напрямую ссылаются на выражение одного столбца в семантической модели, без участия дополнительных столбцов. Они представляют собой агрегации по столбцу на вашей платформе данных и могут фильтроваться по одному или нескольким измерениям.
Параметры простых метрик, их описания и типы:
| Параметр | Описание | Обязательность | Тип |
|---|---|---|---|
name | Имя метрики. Оно должно быть уникальным в пределах проекта и может содержать строчные буквы, цифры и символы подчёркивания. Используйте это имя для обращения к метрике через API Semantic Layer. | Обязательный | String |
description | Описание метрики. | Необязательный | String |
type | Тип метрики (cumulative, derived, ratio или simple). | Обязательный | String |
label | Задаёт отображаемое значение в инструментах, использующих метрику. Допускает обычный текст, пробелы и кавычки (например, orders_total или "orders_total"). | Необязательный | String |
agg | Используемая функция агрегации. Используйте sum, max, min, average, median, count, count_distinct, percentile и sum_boolean. | Обязательный | String |
expr | Используемое выражение, например имя столбца. По умолчанию используется имя метрики. | Необязательный | String |
percentile | Используемый процентиль. Обязателен, если agg имеет значение percentile. | Необязательный | Integer |
percentile_type | Используемый тип процентиля. Используйте discrete или continuous. Обязателен для метрик percentile. | Необязательный | String |
non_additive_dimension | Используемое неаддитивное измерение. | Необязательный | String |
agg_time_dimension | Используемое временное измерение. | Необязательный | String |
join_to_timespine | Указывает, следует ли присоединять агрегированную меру к таблице временной шкалы, чтобы заполнить отсутствующие даты. По умолчанию — false. | Необязательный | Boolean |
fill_nulls_with | Задаёт в определении метрики значение для замены null (например, ноль). | Необязательный | Integer |
Ниже приведена полная спецификация простых метрик вместе с примером.
(Версии dbt: v1.12 и новее)Обратите внимание: простые метрики необходимо определять в YAML-записи семантической модели.
models:
- name: my_model
semantic_model:
enabled: true
...
metrics:
- name: my_simple_metric # Обязательно
description: The metric description # Необязательно
label: My simple metric label # Необязательно
type: simple # Обязательно
agg: count_distinct # Обязательно: sum | max | min | average | median | count_distinct | percentile и sum_boolean
expr: case when is_a then 1 else 0 end # Необязательно для простой метрики; по умолчанию используется имя метрики
join_to_timespine: true
fill_nulls_with: 0
- name: my_simple_metric_that_uses_the_other_time_dimension
description: The metric description
label: My simple metric that uses the other time dimension label
type: simple
agg: count_distinct
agg_time_dimension: my_other_time_dimension_column # Необязательно, если используется не временное измерение по умолчанию
Для расширенного моделирования данных можно использовать fill_nulls_with и join_to_timespine, чтобы заменять значения null в метриках нулями, обеспечивая числовые значения для каждой строки данных.
Пример простых метрик
(Версии dbt: v1.12 и новее) metrics:
- name: customers
description: Количество клиентов
type: simple
label: Количество клиентов
agg: count
expr: customers
fill_nulls_with: 0
join_to_timespine: true
filter: "{{ Dimension('customer__customer_total') }} >= 20"
# alias не поддерживается для простых метрик
# используйте alias в input_metrics при ссылке на эту метрику в производных метриках, метриках отношения или конверсии
- name: large_orders
description: "Заказ со стоимостью более 20."
type: simple
label: Крупные заказы
agg: count
expr: orders
filter: "{{ Dimension('customer__order_total_dim') }} >= 20"
Связанная документация
Нашли ошибку?
0