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

Простые метрики

(Версии dbt: v1.12 и новее)

Простые метрики — это метрики, которые напрямую ссылаются на выражение одного столбца в семантической модели, без участия дополнительных столбцов. Они представляют собой агрегации по столбцу на вашей платформе данных и могут фильтроваться по одному или нескольким измерениям.

Параметры простых метрик, их описания и типы:

ПараметрОписаниеОбязательностьТип
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
Loading