# Конфигурации моделей

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

* [Модели](https://docs.getdbt.tech/docs/build/models.md)
* [Команда `run`](https://docs.getdbt.tech/reference/commands/run.md)

## Доступные конфигурации

### Конфигурации, специфичные для модели

Конфигурации, специфичные для ресурса, применимы только к одному типу ресурса dbt, а не к нескольким типам ресурсов. Вы можете определить эти настройки в файле проекта (`dbt_project.yml`), в файле свойств (`models/properties.yml` для моделей, аналогично для других ресурсов) или внутри файла ресурса, используя макрос `{{ config() }}`.<br />

Следующие конфигурации, специфичные для ресурса, доступны только для Models:

### Файл проекта

dbt\_project.yml

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

```yaml
models:
  <resource-path>:
    +materialized: <materialization_name>
    +sql_header: <string>
    +on_configuration_change: apply | continue | fail # only for materialized views on supported adapters
    +unique_key: <column_name_or_expression>
    +freshness: <dict>
    +on_error: skip_children | continue
    +latest_version_pointer: <dict>
```

### Файл свойств

(Версии dbt: v2.0 и новее)

models/properties.yml

```yaml

models:
  - name: [<model-name>]
    config:
      materialized: <materialization_name>
      sql_header: <string>
      on_configuration_change: apply | continue | fail # only for materialized views on supported adapters
      unique_key: <column_name_or_expression>
      freshness:
        warn_after: {count: 24, period: hour}
        error_after: {count: 48, period: hour}
        build_after: <dict>        # build scheduling — Enterprise only
      loaded_at_field: updated_at  # or loaded_at_query
      on_error: skip_children | continue
      latest_version_pointer: <dict>
```

### Конфигурация в SQL‑файле

models/\<model\_name>.sql

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

```sql

{{ config(
    materialized="<materialization_name>",
    sql_header="<string>"
    on_configuration_change: apply | continue | fail # only for materialized views for supported adapters
    unique_key='column_name_or_expression'
    freshness=<dict>
    on_error="skip_children" | "continue"
    latest_version_pointer=<dict>
) }}
```

### Общие конфигурации

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

### Файл проекта

dbt\_project.yml

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

```yaml
models:
  <resource-path>:
    +enabled: true | false
    +tags: <string> | [<string>]
    +pre-hook: <sql-statement> | [<sql-statement>]
    +post-hook: <sql-statement> | [<sql-statement>]
    +database: <string>
    +schema: <string>
    +alias: <string>
    +persist_docs: <dict>
    +full_refresh: <boolean>
    +meta: {<dictionary>}
    +grants: {<dictionary>}
    +contract: {<dictionary>}
    +event_time: my_time_field
```

### Файл свойств

models/properties.yml

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

```yaml

models:
  - name: [<model-name>]
    config:
      enabled: true | false
      tags: <string> | [<string>]
      pre_hook: <sql-statement> | [<sql-statement>]
      post_hook: <sql-statement> | [<sql-statement>]
      database: <string>
      schema: <string>
      alias: <string>
      persist_docs: <dict>
      full_refresh: <boolean>
      meta: {<dictionary>}
      grants: {<dictionary>}
      contract: {<dictionary>}
      event_time: my_time_field
```

### Конфигурация в SQL-файле

models/\<model\_name>.sql

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

```sql

{{ config(
    enabled=true | false,
    tags="<string>" | ["<string>"],
    pre_hook="<sql-statement>" | ["<sql-statement>"],
    post_hook="<sql-statement>" | ["<sql-statement>"],
    database="<string>",
    schema="<string>",
    alias="<string>",
    persist_docs={<dict>},
    meta={<dict>},
    grants={<dict>},
    contract={<dictionary>},
    event_time='my_time_field',

) }}
```

### Конфигурации, специфичные для хранилища

* [Конфигурации BigQuery](https://docs.getdbt.tech/reference/resource-configs/bigquery-configs.md)
* [Конфигурации Redshift](https://docs.getdbt.tech/reference/resource-configs/redshift-configs.md)
* [Конфигурации Snowflake](https://docs.getdbt.tech/reference/resource-configs/snowflake-configs.md)
* [Конфигурации Databricks](https://docs.getdbt.tech/reference/resource-configs/databricks-configs.md)
* [Конфигурации Spark](https://docs.getdbt.tech/reference/resource-configs/spark-configs.md)

## Конфигурирование моделей

Конфигурации моделей применяются иерархически. Вы можете настраивать модели как в установленном пакете, так и в вашем проекте dbt следующими способами, перечисленными в порядке приоритета:

1. Используя Jinja-макрос `config()` внутри модели.
2. Используя `config` как [свойство ресурса](https://docs.getdbt.tech/reference/model-properties.md) в `.yml`‑файле.
3. Из YAML‑файла проекта (`dbt_project.yml`), в разделе `models:`. В этом случае модель, находящаяся на самом глубоком уровне вложенности, будет иметь наивысший приоритет.

Наиболее специфичная конфигурация всегда имеет приоритет. Например, в YAML‑файле проекта конфигурации, применённые к подкаталогу `marketing`, будут иметь приоритет над конфигурациями, применёнными ко всему проекту `jaffle_shop`. Чтобы применить конфигурацию к модели или каталогу моделей, определите [путь к ресурсу](https://docs.getdbt.tech/reference/resource-configs/resource-path.md) в виде вложенных ключей словаря.

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

## Пример

### Конфигурирование каталогов моделей в `dbt_project.yml`

Чтобы настроить модели в вашем файле `dbt_project.yml`, используйте опцию конфигурации `models:`. Убедитесь, что вы указали пространство имен для ваших конфигураций в вашем проекте (показано ниже):

dbt\_project.yml

```yml

name: dbt_labs

models:
  # Убедитесь, что вы указали пространство имен для конфигураций моделей в вашем проекте
  dbt_labs:

    # Это настраивает модели, найденные в models/events/
    events:
      +enabled: true
      +materialized: view

      # Это настраивает модели, найденные в models/events/base
      # Эти модели будут эфемерными, так как конфигурация выше будет переопределена
      base:
        +materialized: ephemeral

      ...
```

### Применение конфигураций только к одной модели

Некоторые типы конфигураций специфичны для конкретной модели. В этих случаях размещение конфигураций в файле `dbt_project.yml` может быть неудобным. Вместо этого вы можете указать эти конфигурации в начале файла модели `.sql` или в его индивидуальных YAML-свойствах.

models/events/base/base\_events.sql

````sql
{{
  config(
    materialized = "table",
    tags = ["core", "events"]
  )
}}

```sql
select * from {{ ref('raw_events') }}
````

models/events/base/properties.yml

```yaml

models:
  - name: base_events
    description: "Standardized event data from raw sources"
    columns:
      - name: user_id
        description: "Unique identifier for a user"
        data_tests:
          - not_null
          - unique
      - name: event_type
        description: "Type of event recorded (click, purchase, etc.)"
```

(Версии dbt: v2.0 и новее)

### Configuring model freshness

You can use the `freshness` config in the following ways:

* **Freshness SLA** (`warn_after`, `error_after`): To declare how stale this model's data is allowed to be. dbt evaluates these thresholds when you run [`dbt freshness`](https://docs.getdbt.tech/reference/commands/freshness.md) and reports `Pass`, `Warn`, or `Error`. Support varies by materialization and measurement method. Refer to the [measurement methods table](https://docs.getdbt.tech/reference/commands/freshness.md#how-freshness-is-evaluated) for more information.

* **Build scheduling** (`build_after`): To skip rebuilding a model when upstream data hasn't changed since the last build. Available on dbt platform Enterprise tiers only.

models/my\_model.yml

```yml
models:
  - name: stg_orders
    config:
      freshness:
        # Freshness SLA — report warn/error when data is stale
        warn_after: {count: 24, period: hour}
        error_after: {count: 48, period: hour}
        # Build scheduling — Enterprise only
        build_after:
          count: 6
          period: hour
          updates_on: any  # optional
      loaded_at_field: updated_at  # or loaded_at_query
```
