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

Метрики отношений

Метрики отношений позволяют вычислять отношение двух метрик. Вы указываете метрику для числителя и метрику для знаменателя. При вычислении метрики можно дополнительно применять фильтры, имена и псевдонимы как к числителю, так и к знаменателю.

Параметры метрик отношений:

(Версии dbt: v1.12 и новее)
ПараметрОписаниеОбязательностьТип
nameИмя метрики.ОбязательныйСтрока
descriptionОписание метрики.НеобязательныйСтрока
typeТип метрики (cumulative, derived, ratio или simple).ОбязательныйСтрока
labelПодпись для внешних инструментов. Допускаются обычный текст, пробелы и кавычки, например orders_total или "orders_total".НеобязательныйСтрока
numeratorМетрика для числителя. Можно указать имя метрики строкой или словарь с полями name, filter и alias.ОбязательныйСтрока или словарь
denominatorМетрика для знаменателя. Можно указать имя метрики строкой или словарь с полями name, filter и alias.ОбязательныйСтрока или словарь

Поля словарей числителя и знаменателя​

Для словарей числителя и знаменателя доступны следующие поля:

ПолеОписаниеОбязательностьТип
nameИмя метрики.ОбязательноеСтрока
filterФильтр для метрики.НеобязательноеСтрока
aliasПсевдоним метрики.НеобязательноеСтрока

Полная спецификация метрики-отношения:

(Версии dbt: v1.12 и новее)
models/file_name.yml
models:
- name: file_name
semantic_model:
- enabled: true # required
- name: my_semantic_model
... rest of config...
metrics:
- name: my_advanced_ratio_metric
type: ratio
numerator:
name: my_simple_metric
filter: "{{ Dimension('my_primary_entity__my_categorical_dimension_column') }} > 10"
alias: joel_loves_data
denominator:
name: my_simple_metric_that_uses_the_other_time_dimension_but_is_also_from_another_semantic_model
filter: "{{ Dimension('my_primary_entity__my_categorical_dimension_column') }} < 10"
alias: joel_hates_data

Для продвинутого моделирования данных можно использовать fill_nulls_with и join_to_timespine, чтобы заменить значения null в метриках на нули, обеспечивая числовые значения в каждой строке данных.

Пример метрик отношения​

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

Пример 1​

Этот пример представляет собой базовую метрику отношения, которая вычисляет отношение заказов на еду к общему количеству заказов:

(Версии dbt: v1.12 и новее)
models/file_name.yml
metrics:
- name: food_order_pct
description: "Количество заказов еды как доля от общего количества заказов"
label: Food order ratio
type: ratio
numerator: food_orders
denominator: orders

Пример 2​

В этом примере метрика отношения вычисляет отношение количества заказов еды к общему количеству заказов, при этом к числителю применяются фильтр и псевдоним. Обратите внимание: чтобы добавить эти атрибуты, вам также потребуется явно указать ключ для атрибута name.

(Версии dbt: v1.12 и новее)
models/file_name.yml
metrics:
- name: food_order_pct
description: "Количество заказов еды как доля от общего количества заказов"
label: Доля заказов еды по местоположению
type: ratio
numerator:
name: food_orders
filter: location = 'New York'
alias: ny_food_orders
denominator:
name: orders
filter: location = 'New York'
alias: ny_orders

Метрики отношения с использованием разных семантических моделей​

Система упростит вычисление метрики отношения на основе разных семантических моделей, вычислив значения числителя и знаменателя в подзапросах. Затем она объединит результирующие наборы данных по общим измерениям, чтобы вычислить итоговое отношение. Ниже приведён пример SQL, сгенерированного для такой метрики отношения.

Система упростит и преобразует числитель и знаменатель в метрику отношения из различных семантических моделей, вычисляя их значения в подзапросах. Затем она объединит результирующий набор на основе общих измерений для вычисления окончательного отношения. Вот пример SQL, сгенерированного для такой метрики отношения.

select
subq_15577.metric_time as metric_time,
cast(subq_15577.mql_queries_created_test as double) / cast(nullif(subq_15582.distinct_query_users, 0) as double) as mql_queries_per_active_user
from (
select
metric_time,
sum(mql_queries_created_test) as mql_queries_created_test
from (
select
cast(query_created_at as date) as metric_time,
case when query_status in ('PENDING','MODE') then 1 else 0 end as mql_queries_created_test
from prod_dbt.mql_query_base mql_queries_test_src_2552
) subq_15576
group by
metric_time
) subq_15577
inner join (
select
metric_time,
count(distinct distinct_query_users) as distinct_query_users
from (
select
cast(query_created_at as date) as metric_time,
case when query_status in ('MODE','PENDING') then email else null end as distinct_query_users
from prod_dbt.mql_query_base mql_queries_src_2585
) subq_15581
group by
metric_time
) subq_15582
on
(
(
subq_15577.metric_time = subq_15582.metric_time
) or (
(
subq_15577.metric_time is null
) and (
subq_15582.metric_time is null
)
)
)

Добавление фильтра​

Пользователи могут определять ограничения на входные метрики для метрики отношения, применяя фильтр непосредственно к входной метрике, следующим образом:

(Версии dbt: v1.12 и новее)
models/file_name.yml
metrics:
- name: frequent_purchaser_ratio
description: Fraction of active users who qualify as frequent purchasers
type: ratio
numerator:
name: distinct_purchasers
filter: |
"{{ Dimension('customer__is_frequent_purchaser') }}"
alias: frequent_purchasers
denominator:
name: distinct_purchasers

Обратите внимание на параметры filter и alias для метрики, указанной в числителе.

  • Используйте параметр filter, чтобы применить фильтр к метрике, к которой он относится.
  • Параметр alias используется для предотвращения конфликтов имен в сгенерированных SQL-запросах, когда одна и та же метрика используется с разными фильтрами.
  • Если конфликтов имен нет, параметр alias можно опустить.

Нашли ошибку?

0
Loading