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

(Версии 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-записи семантической модели.

```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 в метриках нулями](https://docs.getdbt.tech/docs/build/fill-nulls-advanced.md), обеспечивая числовые значения для каждой строки данных.

## Пример простых метрик

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

```yaml
  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"
```

## Связанная документация

* [Заполнение значений null для простых, производных метрик или метрик отношения](https://docs.getdbt.tech/docs/build/fill-nulls-advanced.md)
