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

Заполнение null-значений для метрик

Понимание и реализация стратегий заполнения null-значений в метриках является ключевым для точной аналитики. В этом руководстве объясняются fill_nulls_with и join_to_timespine, чтобы обеспечить полноту данных, помогая конечным пользователям принимать более обоснованные решения и улучшая ваши рабочие процессы dbt.

О null-значениях​

Вы можете использовать fill_nulls_with, чтобы заменить null-значения в метриках на значение, например, ноль (или выбранное вами целое число). Это гарантирует, что каждая строка данных показывает числовое значение.

Это руководство объясняет, как гарантировать отсутствие null-значений в ваших метриках:

  • Используйте fill_nulls_with для simple, cumulative и conversion метрик
  • Используйте join_to_timespine и fill_nulls_with вместе для производных и долевых метрик, чтобы избежать появления null-значений.

Заполнение null-значений для простых метрик​

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

Предположим, у вас есть три метрики:

  • website_visits и leads
  • и производная метрика под названием leads_to_website_visit, которая вычисляет отношение лидов к посещениям сайта.
(Версии dbt: v1.12 и новее)

Для дней без конверсий можно задать нулевое значение метрики лидов с помощью параметра fill_nulls_with:

models/website_visits.yml
# Define simple metrics within a semantic model
models:
- name: website_visits_model
semantic_model:
enabled: true
# ... other configs ...
metrics:
- name: website_visits
type: simple
agg: count
- name: leads
type: simple
agg: count
fill_nulls_with: 0 # This fills null values with zero
- name: leads_to_website_visit
type: derived
expr: leads/website_visits
input_metrics:
- name: leads
- name: website_visits

Метрики website_visits и leads имеют следующие данные:

metric_timewebsite_visits
2024-01-0150
2024-01-0237
2024-01-0379
metric_timeleads
2024-01-015
2024-01-038
  • Обратите внимание, что в метрике leads нет данных за 2024-01-02.

Хотя нет дней без посещений, есть дни без лидов. После применения fill_nulls_with: 0 к метрике leads, запрос этих метрик вместе показывает ноль для лидов в дни без конверсий:

metric_timewebsite_visitsleads
2024-01-01505
2024-01-02370
2024-01-03798

Использование join_to_timespine для производных и долевых метрик​

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

Чтобы обеспечить полный набор данных и ежедневное покрытие для метрик, вычисляемых на основе других метрик, можно использовать join_to_timespine для заполнения значений null в метриках derived и ratio. Эти метрики строятся на основе других метрик (других вычислений), а не прямых агрегаций, поэтому MetricFlow требуется дополнительный уровень подзапроса для формирования метрики. Вложенность подзапросов выглядит следующим образом:

  • Для метрик derived и ratio используются три уровня вложенности подзапросов — метрика derived или ratio → входные метрики → метрики simple с агрегациями.
  • Для метрик simple и cumulative используются только два уровня вложенности подзапросов — метрика simple или cumulative → агрегация.

Поскольку coalesce не применяется к третьему уровню подзапросов для метрик derived или ratio, в итоговом наборе результатов всё ещё могут оставаться значения null.

Обратите внимание: join_to_timespine также можно использовать с метриками simple, если нужно включить строку для каждой даты, даже если данных нет.

Заполнение значений null для метрик derived и ratio​

Чтобы заполнить значения null для метрик derived и ratio, можно связать их с временной шкалой (time spine), обеспечив ежедневное покрытие данными. Как упоминалось в предыдущем разделе, это связано с тем, что метрики derived и ratio принимают на вход метрики.

Например, следующая структура оставляет null-значения в конечных результатах (столбец leads_to_website_visit), потому что COALESCE не применяется на третьем внешнем уровне рендеринга для окончательного расчета метрики в derived метриках:

metric_timewebsite_visitsleadsleads_to_website_visit
2024-01-01505.1
2024-01-02370null
2024-01-03798.1

Чтобы отобразить нулевое значение leads_to_website_visit за 2024-01-02, нужно соединить метрику leads с моделью временной шкалы (time spine), чтобы обеспечить наличие значения для каждого дня. Для этого добавьте join_to_timespine в (Версии dbt: v1.12 и новее) простую метрику в конфигурации метрики leads:

(Версии dbt: v1.12 и новее)
models/leads.yml
models:
- name: leads_model
semantic_model:
enabled: true
# ... other configs ...
metrics:
- name: leads
type: simple
agg: count
fill_nulls_with: 0
join_to_timespine: true

После этого при запросе метрики leads после соединения с временной шкалой (timespine) будет возвращаться запись для каждого дня, а все значения null будут заменены нулями.

metric_timeleadsleads_to_website_visit
2024-01-015.1
2024-01-0200
2024-01-038.1

Теперь, если вы объедините метрики в derived метрике, будет нулевое значение для leads_to_website_visit на 2024-01-02, и в конечном наборе результатов не будет никаких null-значений.

Часто задаваемые вопросы​

 Как обрабатывать null-значения в производных метриках, определенных на основе нескольких таблиц

Для дополнительных примеров и обсуждения того, как обрабатывать null-значения в производных метриках, использующих данные из нескольких таблиц, ознакомьтесь с вопросом MetricFlow #1031.

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

0
Loading