Простые метрики
Простые метрики — это метрики, которые напрямую ссылаются на одну меру, без участия дополнительных мер. Они представляют собой агрегации по столбцу в вашей платформе данных и могут быть отфильтрованы по одному или нескольким измерениям.
Параметры, описание и тип для простых метрик:
Обратите внимание, что мы используем двойное двоеточие (::), чтобы указать, вложен ли параметр в другой параметр. Например, query_params::metrics означает, что параметр metrics вложен в query_params.
| Параметр | Описание | Обязательный | Тип |
|---|---|---|---|
name | Имя метрики. | Обязательный | Строка |
description | Описание метрики. | Необязательный | Строка |
type | Тип метрики (накопительный, производный, отношение или простой). | Обязательный | Строка |
label | Определяет отображаемое значение в инструментах нижнего уровня. Принимает обычный текст, пробелы и кавычки (например, orders_total или "orders_total"). | Обязательный | Строка |
type_params | Параметры типа метрики. | Обязательный | Словарь |
measure | Список входных данных меры. | Обязательный | Список |
measure:name | Мера, на которую вы ссылаетесь. | Обязательный | Строка |
measure:alias | Необязательный alias для переименования меры. | Необязательный | Строка |
measure:filter | Необязательный filter, применяемый к мере. | Необязательный | Строка |
measure:fill_nulls_with | Установите значение в определении метрики вместо null (например, ноль). | Необязательный | Строка |
measure:join_to_timespine | Указывает, должна ли агрегированная мера быть присоединена к таблице временной шкалы для заполнения отсутствующих дат. По умолчанию false. | Необязательный | Логический |
Ниже представлена полная спецификация для простых метрик, а также пример.
metrics:
- name: Имя метрики # Обязательный
description: Описание метрики # Необязательный
type: simple # Обязательный
label: Значение, которое будет отображаться в инструментах нижнего уровня # Обязательный
type_params: # Обязательный
measure:
name: Имя вашей меры # Обязательный
alias: Псевдоним, применяемый к мере. # Необязательный
filter: Фильтр, применяемый к мере. # Необязательный
fill_nulls_with: Установите значение вместо null (например, ноль) # Необязательный
join_to_timespine: true/false # Логический параметр, указывающий, должна ли агрегированная мера быть присоединена к таблице временной шкалы для заполнения отсутствующих дат. # Необязательный
Для продвинутого моделирования данных вы можете использовать fill_nulls_with и join_to_timespine, чтобы установить значения null метрик в ноль, обеспечивая числовые значения для каждой строки данных.
Пример простых метрик
metrics:
- name: customers
description: Количество клиентов
type: simple # Указатель на меру, созданную в семантической модели
label: Количество клиентов
type_params:
measure:
name: customers # Мера, для которой вы создаете прокси.
fill_nulls_with: 0
join_to_timespine: true
alias: customer_count
filter: {{ Dimension('customer__customer_total') }} >= 20
- name: large_orders
description: "Заказы с суммой заказа более 20."
type: simple
label: Большие заказы
type_params:
measure:
name: orders
filter: | # Для любой метрики вы можете дополнительно включить фильтр по значениям измерений
{{Dimension('customer__order_total_dim')}} >= 20