# Устаревающие возможности

Устаревающие возможности — это элементы кода вашего проекта (модели, конфигурации, синтаксис), которые перестанут работать в будущих версиях.

примечание

Устаревшая функциональность по-прежнему работает в версии v1.10, но больше не поддерживается и будет удалена в одной из будущих версий. Сейчас сообщения об устаревшей функциональности отображаются как предупреждения и не препятствуют выполнению запусков и других команд (если вы не настроили [обработку предупреждений как ошибок](https://docs.getdbt.tech/reference/global-configs/warnings.md)), но после обновления они приведут к ошибкам, если не устранить их причины.

Это не то же самое, что [флаги изменения поведения](https://docs.getdbt.tech/reference/global-configs/behavior-changes.md) (флаги в файле `dbt_project.yml`, позволяющие включать или отключать изменения поведения) или [устаревшие флаги CLI](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v2.md#deprecated-flags) (флаги командной строки, которые удаляются в dbt v2). Краткое сравнение см. в разделе [Обзор изменений](https://docs.getdbt.tech/reference/changes-overview.md).

Переходите на [dbt v2](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v2.md)? Перед обновлением необходимо устранить все случаи использования устаревшей функциональности, перечисленные на этой странице.

Во время работы dbt генерирует различные категории [событий](https://docs.getdbt.tech/reference/events-logging.md), одна из которых — *сообщения об устаревшей функциональности*. Это особый тип предупреждений, сообщающих о проблемах в отдельных частях вашего проекта, которые приведут к несовместимым изменениям в одной из будущих версий dbt. Хотя пока это лишь предупреждения, важно устранить причины всех таких предупреждений в проекте, чтобы в дальнейшем работать безопаснее и увереннее, получая своевременную обратную связь.

## Определение предупреждений об устаревании

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

### dbt CLI

Чтобы просмотреть устаревания через CLI, выполните команду:

```bash
dbt parse --no-partial-parse --show-all-deprecations
```

Флаг `--no-partial-parse` гарантирует, что будут включены даже те устаревания, которые обнаруживаются только на этапе парсинга. Флаг `--show-all-deprecations` обеспечивает вывод каждого случая устаревания, а не только первого.

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

dbt v2 и `dbt parse`

При использовании dbt v2 уберите `--no-partial-parse` из команды выше. Этот флаг устарел в dbt v2 и может вызвать предупреждение `dbt1700`. Запустите `dbt parse --show-all-deprecations` без `--no-partial-parse`.

Подробнее см. [Устаревшие флаги](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v2.md#deprecated-flags) в руководстве по переходу на dbt v2.

```bash
19:15:13 [WARNING]: Deprecated functionality
Summary of encountered deprecations:
- MFTimespineWithoutYamlConfigurationDeprecation: 1 occurrence
```

### Платформа dbt

Если вы используете dbt, вы можете просмотреть предупреждения об устаревании в разделе **Dashboard** вашей учетной записи.

[![Предупреждения об устаревании на панели управления dbt.](/img/docs/dbt-platform/deprecation-warnings.png?v=2 "Предупреждения об устаревании на панели управления dbt.")](#)Предупреждения об устаревании на панели управления dbt.

Откройте задание, чтобы просмотреть подробную информацию и найти предупреждения об устаревании в логах (или выполните команду `parse` с флагами в Studio IDE или dbt platform CLI).

[![Предупреждения об устаревании в логах.](/img/docs/dbt-platform/deprecation-list.png?v=2 "Предупреждения об устаревании в логах.")](#)Предупреждения об устаревании в логах.

### Автоматическое исправление

Некоторые проблемы, связанные с устаревшими возможностями, можно автоматически исправить с помощью скрипта. Подробнее об этом читайте в [этой статье блога dbt](https://www.getdbt.com/blog/how-to-get-ready-for-the-new-dbt-engine#:~:text=2.%20Resolve%20deprecation%20warnings). [Скачайте скрипт](https://github.com/dbt-labs/dbt-autofix) и следуйте инструкциям по установке, чтобы начать работу.

Вы можете запустить этот скрипт непосредственно из [Studio IDE](https://docs.getdbt.tech/docs/platform/studio-ide/autofix-deprecations.md) с помощью кнопки **Autofix warnings**, чтобы устранить предупреждения об устаревших возможностях в dbt platform.

[![Используйте кнопку Autofix warnings в Studio IDE, чтобы устранить предупреждения об устаревших возможностях в dbt platform.](/img/docs/dbt-platform/platform-ide/autofix-button.png?v=2 "Используйте кнопку Autofix warnings в Studio IDE, чтобы устранить предупреждения об устаревших возможностях в dbt platform.")](#)Используйте кнопку Autofix warnings в Studio IDE, чтобы устранить предупреждения об устаревших возможностях в dbt platform.

### Подавление предупреждений об устаревших возможностях

dbt Labs рекомендует устранять причины предупреждений об устаревших возможностях, а не подавлять их. Если вам нужно временно уменьшить количество лишних сообщений в логах, используйте `--warn-error-options` с параметром `silence`. Это работает с любой командой dbt, включая `dbt test` и `dbt parse`.

Полный список вариантов настройки (флаг CLI, переменная окружения и `dbt_project.yml`) приведён в разделе [Предупреждения](https://docs.getdbt.tech/reference/global-configs/warnings.md).

Чтобы подавить все предупреждения об устаревших возможностях в dbt v1:

```bash
dbt test --warn-error-options '{"silence": ["Deprecations"]}'
```

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

В dbt v2 поведение отличается от dbt v1:

* Группа `Deprecations` может подавлять не все предупреждения, связанные с устаревшими возможностями. Предпочтительно указывать конкретное имя события из логов (например, `SemanticModelDeprecated`).
* Некоторые устаревшие настройки в dbt v2 вызывают ошибки, которые нельзя подавить. Такие настройки необходимо исправить.

Подробнее о том, как dbt v2 обрабатывает `warn_error_options`, о поддерживаемых именах и случаях возникновения ошибок, которые нельзя подавить, читайте в разделе [Поведение dbt v2 и коды предупреждений](https://docs.getdbt.tech/reference/global-configs/warnings.md#dbt-v2-behavior-and-warning-codes).

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

### ArgumentsPropertyInGenericTestDeprecation

dbt объявил устаревшей возможность указывать пользовательское свойство верхнего уровня с именем `arguments` в generic-тестах. Это предупреждение возникает только в том случае, если флаг поведения `require_generic_test_arguments_property` установлен в `False`.

В dbt объявлена устаревшей возможность указывать пользовательское свойство верхнего уровня с именем `arguments` в универсальных тестах. Это предупреждение об устаревании выводится только в том случае, если флаг поведения `require_generic_test_arguments_property` установлен в `false`.

Ранее в пользовательских generic-тестах могло использоваться свойство `arguments`:

model.yml

```yaml
models:
  - name: my_model_with_generic_test
    data_tests:
      - my_custom_generic_test:
          arguments: [1,2,3]
          expression: "order_items_subtotal = subtotal"
```

Следует установить флаг `require_generic_test_arguments_property` в значение `true` и поместить все именованные аргументы теста в новое свойство `arguments`:

model.yml

```yaml
models:
  - name: my_model_with_generic_test
    data_tests:
      - my_custom_generic_test:
          arguments: 
            arguments: [1,2,3]
            expression: "order_items_subtotal = subtotal"
```

В качестве альтернативы исходный ключ `arguments` можно переименовать во что‑то другое, чтобы избежать конфликта с новым ключом `arguments` во фреймворке dbt. Такое переименование также потребуется выполнить в макросе теста, и переименованный ключ всё равно должен находиться внутри свойства `arguments`, чтобы конфигурация была синтаксически корректной. Например:

model.yml

```yaml
models:
  - name: my_model_with_generic_test
    data_tests:
      - my_custom_generic_test:
          arguments:
            renamed_arguments: [1,2,3]
            expression: "order_items_subtotal = subtotal"
```

### ConfigDataPathDeprecation

В [dbt v1.0](<https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/Older versions/upgrading-to-v1.0/.md>) параметр `data-paths` был переименован в [seed-paths](https://docs.getdbt.tech/reference/project-configs/model-paths.md). Если вы получаете это предупреждение об устаревшем параметре, значит, в файле `dbt_project.yml` вашего проекта всё ещё используется `data-paths`.

Пример предупреждения:

CLI

```bash
23:14:58  [WARNING]: Deprecated functionality
The `data-paths` config has been renamed to `seed-paths`. Please update your
`dbt_project.yml` configuration to reflect this change.
```

#### Как устранить предупреждение ConfigDataPathDeprecation

Замените `data-paths` на `seed-paths` в файле `dbt_project.yml`.

### ConfigLogPathDeprecation

В [dbt v1.5](<https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/Older versions/upgrading-to-v1.5/.md>) указание `log-path` в `dbt_project.yml` было объявлено устаревшим. Это предупреждение об устаревании означает, что в вашем файле `dbt_project.yml` по-прежнему указан параметр `log-path` и его значение отличается от значения по умолчанию — `logs`.

Пример:

CLI

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

```bash
23:39:18  [WARNING]: Deprecated functionality
The `log-path` config in `dbt_project.yml` has been deprecated and will no
longer be supported in a future version of dbt-core. If you wish to write dbt
logs to a custom directory, please use the --log-path CLI flag or DBT_ENGINE_LOG_PATH
env var instead.
```

#### Как устранить предупреждение ConfigLogPathDeprecation

Удалите `log-path` из файла `dbt_project.yml` и задайте путь с помощью флага CLI `--log-path` или переменной окружения (Версии dbt: v1.11 и новее) `DBT_ENGINE_LOG_PATH`, [как описано здесь](https://docs.getdbt.tech/reference/global-configs/logs.md#log-and-target-paths).

### ConfigSourcePathDeprecation

В [dbt v1.0](<https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/Older versions/upgrading-to-v1.0/.md>) параметр `source-paths` был переименован в [model-paths](https://docs.getdbt.tech/reference/project-configs/model-paths.md). Это предупреждение об устаревшем параметре означает, что в файле `dbt_project.yml` вашего проекта всё ещё используется `source-paths`.

Пример:

CLI

```bash
23:03:47  [WARNING]: Deprecated functionality
The `source-paths` config has been renamed to `model-paths`. Please update your
`dbt_project.yml` configuration to reflect this change.
23:03:47  Registered adapter: postgres=1.9.0
```

#### Как устранить предупреждение ConfigSourcePathDeprecation

Замените `source-paths` на `model-paths` в `dbt_project.yml`.

### ConfigTargetPathDeprecation

В [dbt 1.5](<https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/Older versions/upgrading-to-v1.5/.md>) указание `target-path` в `dbt_project.yml` было объявлено устаревшим. Это предупреждение об устаревании означает, что `target-path` по-прежнему указан в вашем `dbt_project.yml` и его значение отличается от значения по умолчанию — `target`.

Пример:

CLI

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

```bash
23:22:01  [WARNING]: Deprecated functionality
The `target-path` config in `dbt_project.yml` has been deprecated and will no
longer be supported in a future version of dbt-core. If you wish to write dbt
artifacts to a custom directory, please use the --target-path CLI flag or
DBT_ENGINE_TARGET_PATH env var instead.
```

#### Как устранить предупреждение ConfigTargetPathDeprecation

Удалите `target-path` из файла `dbt_project.yml` и укажите его с помощью флага CLI `--target-path` или переменной окружения (Версии dbt: v1.11 и новее) [`DBT_ENGINE_TARGET_PATH`](https://docs.getdbt.tech/reference/global-configs/logs.md#log-and-target-paths).

### CustomKeyInConfigDeprecation

Это предупреждение возникает, когда вы используете пользовательские (custom) ключи конфигурации, которые dbt не распознаёт как часть официальной спецификации конфигураций. Это относится к конфигурационным блокам как в SQL-, так и в YAML‑файлах.

Пример, который приводит к предупреждению:

```yaml
models:
  - name: my_model
    config:
      custom_config_key: value
```

#### Как устранить предупреждение CustomKeyInConfigDeprecation

Поместите пользовательские ключи под `meta` и убедитесь, что `meta` вложен под `config` (аналогично [`PropertyMovedToConfigDeprecation`](#propertymovedtoconfigdeprecation)). Например:

```yaml
models:
  - name: my_model
    config:
      meta:
        custom_config_key: value
```

### CustomKeyInObjectDeprecation

Это предупреждение отображается, когда вы указываете конфигурацию, которую dbt не распознаёт как часть официальной спецификации конфигов. Это могут быть custom configs или определение `meta` как ключей верхнего уровня в списке `columns`.

Ранее, когда можно было определять любые дополнительные поля напрямую под `config`, это могло приводить к конфликтам между уже существующими пользовательскими конфигурациями и официальными конфигурациями фреймворка dbt.

Начиная с dbt v1.10, а также в dbt v2, ключи конфигурации верхнего уровня будут зарезервированы для официальных настроек фреймворка dbt.

Это предупреждение об устаревании (deprecation warning) выводится **только** для следующих адаптеров:

* Snowflake
* Databricks
* BigQuery
* Redshift

#### Как устранить предупреждение CustomKeyInObjectDeprecation

Поместите пользовательские конфигурации под `meta` и убедитесь, что `meta` вложен под `config` (аналогично [`PropertyMovedToConfigDeprecation`](#propertymovedtoconfigdeprecation)).

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

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

Пример, при котором возникает предупреждение:

```yaml
models:
  - name: my_model
    config:
      custom_config_key: value
    columns:
      - name: my_column
        meta:
          some_key: some_value
```

Пример решения:

```yaml
models:
  - name: my_model
    config:
      meta:
        custom_config_key: value
    columns:
      - name: my_column
        config:
          meta:
            some_key: some_value
```

### Определение универсального теста

Если вы определяете пользовательский ключ непосредственно под тестом в блоке `tests:`, поместите его в `config.meta`.

Пример, вызывающий предупреждение:

```yaml
tests:
  - name: custom_generic_test
    description: My custom generic test
    arguments:
      - name: active_timestamp
        type: timestamp
        description: The active timestamp for the model
```

Пример исправления:

```yaml
tests:
  - name: custom_generic_test
    description: My custom generic test
    config:
      meta:
        arguments:
          - name: active_timestamp
            type: timestamp
            description: The active timestamp for the model
```

#### Доступ к вложенным конфигурациям

Чтобы получить доступ к пользовательским конфигурациям, вложенным в атрибуты `meta`, используйте `config.get('meta')`, а затем обратитесь к словарю meta по имени пользовательского атрибута. Пользователям потребуется изменить код, который обращается к пользовательским ключам конфигурации напрямую как к ключам верхнего уровня.

Пример до того, как пользовательские конфигурации были вложены под meta:

```jinja
{% set my_custom_config = config.get('custom_config_key') %}
```

После того как конфигурации будут вложены:

```jinja
{% set my_custom_config = config.get('meta').custom_config_key %}
```

### CustomOutputPathInSourceFreshnessDeprecation

dbt признал устаревшим флаг `--output` (или `-o`) для переопределения пути, куда записываются результаты source freshness вместо назначения файла `sources.json`.

#### Как устранить предупреждение CustomOutputPathInSourceFreshnessDeprecation

Уберите флаг `--output` или `-o` и связанную с ним конфигурацию пути из любых job, которые запускают команды dbt source freshness. Альтернативы для изменения расположения только результатов source freshness нет. Однако вы по‑прежнему можете использовать `--target-path`, чтобы записывать *все* артефакты шага в кастомное место.

### CustomTopLevelKeyDeprecation

Это предупреждение информирует пользователей о том, что они используют пользовательские ключи верхнего уровня в YAML‑файлах, которые не поддерживаются dbt.

Это предупреждение об устаревании (deprecation warning) выводится **только** для следующих адаптеров:

* Snowflake
* Databricks
* BigQuery
* Redshift

#### Как устранить предупреждение CustomTopLevelKeyDeprecation

Переместите пользовательские ключи верхнего уровня в ваших YAML‑файлах под `config.meta`.

Например, когда вы используете пользовательский ключ верхнего уровня, такой как `custom_metdata`:

dbt\_project.yml

```yaml
models:
  my_project:
    staging:
      +materialized: view
    marts:
      +materialized: table

custom_metadata:
  owner: "data_team"
  description: "This project contains models for our analytics platform"
  last_updated: "2025-07-01"
```

Вам следует переместить этот ключ под `config.meta`:

dbt\_project.yml

```yaml
models:
  my_project:
    staging:
      +materialized: view
    marts:
      +materialized: table

config:
  meta:
    custom_metadata:
      owner: "data_team"
      description: "This project contains models for our analytics platform"
      last_updated: "2025-07-01"
```

### DuplicateNameDistinctNodeTypesDeprecation

dbt выводит это предупреждение, когда два ресурса без версий в одном пакете имеют одинаковое имя (например, модель и seed с именем `sales`), а флаг `require_unique_project_resource_names` установлен в `false`. Ранее dbt не всегда обнаруживал такие конфликты имён, из-за чего ссылки на ресурсы с совпадающими именами иногда могли указывать не на тот ресурс.

Когда флаг `require_unique_project_resource_names` установлен в `true`, dbt выдаёт ошибку `DuplicateResourceNameError`. Подробнее см. в разделе [Уникальные имена ресурсов проекта](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_unique_project_resource_names.md).

#### Как устранить предупреждение DuplicateNameDistinctNodeTypesDeprecation

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

### DuplicateYAMLKeysDeprecation

Это предупреждение возникает, когда в `profiles.yml` существуют два одинаковых ключа.

Ранее, если в [файле `profiles.yml`](https://docs.getdbt.tech/docs/local/profiles.yml.md) встречались одинаковые ключи, dbt использовал последнюю конфигурацию, указанную в файле.

profiles.yml

```yml

my_profile:
  target: 
  outputs:
...

my_profile: # dbt would use this profile key
  target: 
  outputs:
...
```

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

#### Как устранить предупреждение DuplicateYAMLKeysDeprecation

Удалите дублирующиеся ключи из файла `profiles.yml`.

### EnvironmentVariableNamespaceDeprecation

Это предупреждение возникает, когда вы используете переменные окружения, которые конфликтуют с зарезервированным пространством имён dbt `DBT_ENGINE`. Ранее и внутренние переменные dbt, и пользовательские переменные использовали префикс `DBT_`. Если переменная окружения, определённая в dbt, сталкивается с пользовательской переменной окружения, проект может сломаться.

Теперь все новые переменные окружения dbt имеют префикс `DBT_ENGINE`, чтобы предотвратить конфликты имён и минимизировать неудобства для пользователей.

#### EnvironmentVariableNamespaceDeprecation

Проверьте ваши пользовательские переменные окружения и убедитесь, что они не конфликтуют с зарезервированным пространством имён dbt `DBT_ENGINE`.

### ExposureNameDeprecation

Начиная с [dbt 1.3](<https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/Older versions/upgrading-to-v1.3/.md#new-and-changed-documentation>), в свойстве `name` [экспозиций](https://docs.getdbt.tech/reference/exposure-properties.md) допускаются только буквы, цифры и символы подчёркивания.

Пример:

CLI

```bash
23:55:00  [WARNING]: Deprecated functionality
Starting in v1.3, the 'name' of an exposure should contain only letters,
numbers, and underscores. Exposures support a new property, 'label', which may
contain spaces, capital letters, and special characters. stg_&customers does not
follow this pattern. Please update the 'name', and use the 'label' property for
a human-friendly title. This will raise an error in a future version of
dbt-core.
```

#### Как устранить предупреждение ExposureNameDeprecation

Убедитесь, что имена ваших exposures содержат только буквы, цифры и подчёркивания. Более человекочитаемое имя можно указать в свойстве [`label`](https://docs.getdbt.tech/reference/exposure-properties.md#overview) у exposures.

### GenerateSchemaNameNullValueDeprecation

dbt выводит это предупреждение об устаревшем поведении, когда пользовательский макрос `generate_schema_name` возвращает значение `null`. Возврат `null` вместо имени схемы может привести к некорректному или непредсказуемому поведению.

Это предупреждение об устаревшем поведении выводится, когда [флаг `require_valid_schema_from_generate_schema_name`](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_valid_schema_from_generate_schema_name.md) установлен в `false`. Когда флаг установлен в `true`, dbt выдаёт ошибку на этапе разбора.

#### Устранение предупреждения GenerateSchemaNameNullValueDeprecation

Если в вашем проекте определён макрос `generate_schema_name`, обновите его так, чтобы он возвращал допустимое имя схемы. Например:

macros/get\_custom\_schema.sql

```sql
{% macro generate_schema_name(custom_schema_name, node) -%}
    {%- if custom_schema_name is none -%}
        {{ return(target.schema) }}
    {%- else -%}
        {{ custom_schema_name | trim }}
    {%- endif -%}
{%- endmacro %}
```

### GenericJSONSchemaValidationDeprecation

Этот тип устаревания — «универсальный» (catch-all) / запасной вариант. dbt пытается обрабатывать все ошибки валидации JSON Schema через конкретные типы deprecation events, но возможно, мы что-то упустили. «Упустить что-то» означает, что либо dbt не обработал конкретный случай через deprecation event, *либо* JSON Schema некорректна в каком-то месте.

#### Как устранить предупреждение GenericJSONSchemaValidationDeprecation

Если вы видите это предупреждение, к сожалению, на данный момент вы мало что можете сделать, но мы продолжаем работать над тем, чтобы предупреждения об использовании устаревших возможностей появлялись реже. Если вам нужны рекомендации по конкретному случаю, с которым вы столкнулись, [обратитесь в службу поддержки](mailto:support@getdbt.com) (для клиентов облачной платформы dbt) или в [Slack-сообщество](https://www.getdbt.com/community) (для пользователей dbt v1).

### MFCumulativeTypeParamsDeprecation

В dbt [v1.9](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v1.9.md) указание `window` и `time_to_grain` непосредственно в `type_params` [метрики](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_nested_cumulative_type_params.md) было объявлено устаревшим.

Пример:

CLI

```bash
15:36:22  [WARNING]: Cumulative fields `type_params.window` and
`type_params.grain_to_date` has been moved and will soon be deprecated. Please
nest those values under `type_params.cumulative_type_params.window` and
`type_params.cumulative_type_params.grain_to_date`. See documentation on
behavior changes:
https://docs.getdbt.tech/reference/global-configs/behavior-changes.
```

#### Как устранить предупреждение MFCumulativeTypeParamsDeprecation

Переместите `window` и `time_to_grain` под свойство `cumulative_type_params` внутри `type_params` у соответствующей metric.

### MFTimespineWithoutYamlConfigurationDeprecation

До dbt v1.9 конфигурация временной шкалы MetricFlow хранилась в файле `metricflow_time_spine.sql`. В [v1.9](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v1.9.md) в dbt появилось [определение временной шкалы в YAML](https://docs.getdbt.tech/docs/build/metricflow-time-spine.md#configuring-time-spine-in-yaml) для MetricFlow. Впоследствии было решено сделать этот способ стандартным для дальнейшего использования. Если вы видите это предупреждение об устаревании, у вас отсутствует определение временной шкалы в YAML для MetricFlow.

Пример:

CLI

```bash
19:56:41  [WARNING]: Time spines without YAML configuration are in the process of
deprecation. Please add YAML configuration for your 'metricflow_time_spine'
model. See documentation on MetricFlow time spines:
https://docs.getdbt.tech/docs/build/metricflow-time-spine and behavior change
documentation:
https://docs.getdbt.tech/reference/global-configs/behavior-changes
```

#### Как устранить предупреждение MFTimespineWithoutYamlConfigurationDeprecation

Определите timespine для MetricFlow в [YAML](https://docs.getdbt.tech/docs/build/metricflow-time-spine.md#creating-a-time-spine-table).

### MissingArgumentsPropertyInGenericTestDeprecation

В dbt объявлено устаревшим указание именованных аргументов в качестве свойств пользовательских обобщённых тестов данных или тестов данных, использующих [альтернативный формат `test_name`](https://docs.getdbt.tech/reference/resource-properties/data-tests.md#alternative-format-for-defining-tests). Вместо этого аргументы тестов следует указывать в новом свойстве `arguments`.

Это предупреждение об устаревании выводится только в том случае, если флаг поведения `require_generic_test_arguments_property` установлен в `true`.

#### Как устранить предупреждение MissingArgumentsPropertyInGenericTestDeprecation

Если ранее вы задавали аргументы как свойства верхнего уровня в пользовательских generic tests:

model.yml

```yaml
models:
  - name: my_model_with_generic_test
    data_tests:
      - dbt_utils.expression_is_true:
          expression: "order_items_subtotal = subtotal"
```

Или при использовании альтернативного формата `test_name`:

model.yml

```yaml
models:
  - name: my_model_with_generic_test
    data_tests:
    - name: arbitrary_name
      test_name: dbt_utils.expression_is_true
      expression: "order_items_subtotal = subtotal"
      where: "1=1"
```

Теперь вам нужно помещать аргументы под `arguments`, а конфигурации фреймворка — под `config`:

model.yml

```yaml
models:
  - name: my_model_with_generic_test
    data_tests:
      - dbt_utils.expression_is_true:
          arguments: 
            expression: "order_items_subtotal = subtotal"
```

Или с конфигурациями фреймворка:

model.yml

```yaml
models:
  - name: my_model_with_generic_test
    data_tests:
    - name: arbitrary_name
      test_name: dbt_utils.expression_is_true
      arguments:
         expression: "order_items_subtotal = subtotal"
      config:
        where: "1=1"
```

### MissingPlusPrefixDeprecation

dbt объявил устаревшим указание конфигураций без [префикса `+`](https://docs.getdbt.tech/reference/dbt_project.yml.md#the-prefix) в файле `dbt_project.yml`. Теперь только имена папок и файлов могут указываться без префикса `+` внутри конфигураций ресурсов в `dbt_project.yml`.

Пример:

CLI

```bash
18:16:06  [WARNING][MissingPlusPrefixDeprecation]: Deprecated functionality
Missing '+' prefix on `tags` found at `my_path.sub_path.another_path.tags` in
file `dbt_project.yml`. Hierarchical config
values without a '+' prefix are deprecated in dbt_project.yml.
```

Это предупреждение об устаревании (deprecation warning) выводится **только** для следующих адаптеров:

* Snowflake
* Databricks
* BigQuery
* Redshift

#### Как устранить предупреждение MissingPlusPrefixDeprecation

Если ранее вы задавали одну из затронутых конфигураций без префикса `+`, например `materialized`:

dbt\_project.yml

```yaml
models: 
  marts:
    materialized: table
```

Теперь вам нужно задавать её с префиксом `+`, чтобы однозначно различать пути:

dbt\_project.yml

```yaml
models: 
  marts:
    +materialized: table
```

### ModelParamUsageDeprecation

Флаг `--models` / `--model` / `-m` был переименован в `--select` / `--s` ещё в dbt v0.21 (октябрь 2021 года). Пропуск этого флага без предупреждения означает игнорирование критериев выбора, заданных в вашей команде, что может привести к построению всего DAG, хотя вы намеревались выбрать лишь небольшое подмножество. По этой причине флаг `--models` / `--model` / `-m` будет вызывать предупреждение в dbt v1.10 и ошибку в dbt v2. Обновите определения своих заданий соответствующим образом.

#### Как устранить предупреждение ModelParamUsageDeprecation

Обновите определения job: уберите флаг `--models` / `--model` / `-m` и замените его на `--select` / `--s`.

### ModulesItertoolsUsageDeprecation

dbt признал устаревшим использование `modules.itertools` в Jinja.

Пример:

CLI

```bash
15:49:33  [WARNING]: Deprecated functionality
Usage of itertools modules is deprecated. Please use the built-in functions
instead.
```

#### Как устранить предупреждение ModulesItertoolsUsageDeprecation

Если вы сейчас используете функции из модуля `itertools` в SQL-шаблонах Jinja, используйте вместо них доступные встроенные [функции dbt](https://docs.getdbt.tech/reference/dbt-jinja-functions-context-variables.md) и [методы Jinja](https://docs.getdbt.tech/docs/build/jinja-macros.md).

Например, следующий SQL‑файл:

models/itertools\_usage.sql

```sql
{%- set A = [1, 2] -%}
{%- set B = ['x', 'y', 'z'] -%}
{%- set AB_cartesian = modules.itertools.product(A, B) -%}

{%- for item in AB_cartesian %}
  {{ item }}
{%- endfor -%}
```

Его следует переписать, используя альтернативные встроенные Jinja‑методы dbt. Например:

macros/cartesian\_product.sql

```sql
{%- macro cartesian_product(list1, list2) -%}
  {%- set result = [] -%}
  {%- for item1 in list1 -%}
    {%- for item2 in list2 -%}
      {%- set _ = result.append((item1, item2)) -%}
    {%- endfor -%}
  {%- endfor -%}
  {{ return(result) }}
{%- endmacro -%}
```

models/itertools\_usage.sql

```sql
{%- set A = [1, 2] -%}
{%- set B = ['x', 'y', 'z'] -%}
{%- set AB_cartesian = cartesian_product(A, B) -%}

{%- for item in AB_cartesian %}
  {{ item }}
{%- endfor -%}
```

### PackageInstallPathDeprecation

Расположение по умолчанию, куда устанавливаются пакеты при запуске `dbt deps`, было изменено с `dbt_modules` на `dbt_packages`. Во время выполнения `dbt clean` dbt обнаружил, что `dbt_modules` указан в свойстве [clean-targets](https://docs.getdbt.tech/reference/project-configs/clean-targets.md) в `dbt_project.yml`, хотя `dbt_modules` не является значением [`packages-install-path`](https://docs.getdbt.tech/reference/project-configs/packages-install-path.md).

Пример:

CLI

```bash
22:48:01  [WARNING]: Deprecated functionality
The default package install path has changed from `dbt_modules` to
`dbt_packages`. Please update `clean-targets` in `dbt_project.yml` and
check `.gitignore`. Or, set `packages-install-path: dbt_modules`
If you'd like to keep the current value.
```

#### Как устранить предупреждение PackageInstallPathDeprecation

Рекомендуемые подходы:

1. Замените `dbt_modules` на `dbt_packages` в спецификации `clean-targets` (и в `.gitignore`).
2. Установите `packages-install-path: dbt_modules`, если вы хотите продолжать устанавливать пакеты в `dbt_modules`.

### PackageMaterializationOverrideDeprecation

Поведение, при котором установленные пакеты могли переопределять встроенные материализации без вашего явного согласия, объявлено устаревшим. Установка [флага `require_explicit_package_overrides_for_builtin_materializations`](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_explicit_package_overrides_for_builtin_materializations.md) в значение `false` в файле `dbt_project.yml` позволяла материализациям из пакетов, имена которых совпадали с именами встроенных материализаций, по-прежнему учитываться при поиске и определении используемой материализации.

#### Как устранить предупреждение PackageMaterializationOverrideDeprecation

Явно переопределите встроенные материализации в пользу материализации, определённой в пакете: переимплементируйте встроенную материализацию в вашем корневом проекте и оберните реализацию из пакета.

Например:

```jinja

{% materialization table, snowflake %}
    {{ return (package_name.materialization_table_snowflake()) }}
{% endmaterialization %}
```

После того как вы добавите override для вашего пакета, удалите флаг `require_explicit_package_overrides_for_builtin_materializations: false` из `dbt_project.yml`, чтобы устранить предупреждение.

### PackageRedirectDeprecation

Это предупреждение об устаревании означает, что пакет, который сейчас используется в вашем проекте и указан в `packages.yml`, был переименован. Обычно это происходит, когда меняется владелец пакета или его область применения. Вероятно, пакет, на который сейчас ссылается ваш `packages.yml`, больше не поддерживается активно (поскольку разработка переехала на новое имя пакета), и в какой‑то момент пакет со старым именем перестанет работать с dbt.

CLI

```bash
22:31:38  [WARNING]: Deprecated functionality
The `fishtown-analytics/dbt_utils` package is deprecated in favor of
`dbt-labs/dbt_utils`. Please update your `packages.yml` configuration to use
`dbt-labs/dbt_utils` instead.
```

#### Как устранить предупреждение PackageRedirectDeprecation

Начните ссылаться на новый пакет в `packages.yml` вместо старого пакета.

### ProjectFlagsMovedDeprecation

Свойство `config`, которое можно было настраивать в `profiles.yml`, было признано устаревшим в пользу `flags` в `dbt_project.yaml`. Если вы видите это предупреждение об устаревании, значит dbt обнаружил свойство `config` в вашем `profiles.yml`.

Пример:

CLI

```bash
00:08:12  [WARNING]: Deprecated functionality
User config should be moved from the 'config' key in profiles.yml to the 'flags' key in dbt_project.yml.
```

#### Как устранить предупреждение ProjectFlagsMovedDeprecation

Удалите `config` из `profiles.yml`. Перенесите любые прежние настройки [`config`](https://docs.getdbt.tech/reference/global-configs/about-global-configs.md) из `profiles.yml` в `flags` в `dbt_project.yml`.

### PropertyMovedToConfigDeprecation

Некоторые прежние свойства полностью переносятся в параметры конфигурации.

Сюда входят: `freshness`, `meta`, `tags`, `docs`, `group` и `access`.

Перевод некоторых properties в configs полезен тем, что вы можете задавать их сразу для многих ресурсов в `dbt_project.yml` (дефолты на уровне проекта/папок). Подробнее о разнице между properties и configs — [здесь](https://docs.getdbt.tech/reference/configs-and-properties.md).

#### Как устранить предупреждение PropertyMovedToConfigDeprecation

Если ранее вы задавали одно из затронутых properties, например `freshness`:

```yaml

sources: 
  - name: ecom
    schema: raw
    description: E-commerce data for the Jaffle Shop
    freshness:
      warn_after:
        count: 24
        period: hour
```

Теперь вам нужно задавать это под `config`:

```yaml

sources: 
  - name: ecom
    schema: raw
    description: E-commerce data for the Jaffle Shop
    config:
      freshness:
        warn_after:
          count: 24
          period: hour
```

### ResourceNamesWithSpacesDeprecation

В [dbt 1.8](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v1.8.md#managing-changes-to-legacy-behaviors) использование пробелов в именах ресурсов было объявлено устаревшим. Если вы видите это предупреждение об устаревании, значит dbt обнаружил имя ресурса с пробелом.

Пример:

CLI

```bash
16:37:58  [WARNING]: Found spaces in the name of `model.jaffle_shop.stg supplies`
```

#### Как устранить предупреждение ResourceNamesWithSpacesDeprecation

Переименуйте ресурс-нарушитель, чтобы в его имени больше не было пробела.

### SourceFreshnessProjectHooksNotRun

Если вы видите это сообщение, значит, флаг поведения `source_freshness_run_project_hooks` установлен в `false` и определён хук `on-run-start` или `on-run-end` ([документация](https://docs.getdbt.tech/reference/global-configs/behavior-flags/source_freshness_run_project_hooks.md)). Ранее при выполнении `dbt source freshness` хуки проекта не запускались для источников.

Пример:

CLI

```bash
19:51:56  [WARNING]: In a future version of dbt, the `source freshness` command
will start running `on-run-start` and `on-run-end` hooks by default. For more
information: https://docs.getdbt.tech/reference/global-configs/legacy-behaviors
```

#### Как устранить предупреждение SourceFreshnessProjectHooksNotRun

Установите `source_freshness_run_project_hooks` в значение `true`. Инструкции по пропуску хуков проекта при вызове `dbt source freshness` см. в [документации по изменению поведения](https://docs.getdbt.tech/reference/global-configs/behavior-flags/source_freshness_run_project_hooks.md).

### SourceOverrideDeprecation

Свойство `overrides` для sources признано устаревшим.

Это предупреждение об устаревании (deprecation warning) выводится **только** для следующих адаптеров:

* Snowflake
* Databricks
* BigQuery
* Redshift

#### Как устранить предупреждение SourceOverrideDeprecation

Удалите свойство `overrides` и вместо этого [включайте или отключайте source](https://docs.getdbt.tech/reference/source-configs.md#configuring-sources) из пакета.

### UnexpectedJinjaBlockDeprecation

Если у вас есть неожиданный Jinja‑блок — «сиротский» Jinja‑блок или Jinja‑блок вне контекста макроса — вы получите предупреждение, и в будущей версии dbt перестанет поддерживать неожиданные Jinja‑блоки. Ранее такие Jinja‑блоки «тихо» игнорировались.

macros/my\_macro.sql

```sql

{% endmacro %} # orphaned endmacro jinja block

{% macro hello() %}
hello!
{% endmacro %}
```

#### Как устранить предупреждение UnexpectedJinjaBlockDeprecation

Удалите неожиданные Jinja‑блоки.

### WEOIncludeExcludeDeprecation

Опции `include` и `exclude` для `warn_error_options` признаны устаревшими и заменены на `error` и `warn` соответственно.

#### Как устранить предупреждение WEOIncludeExcludeDeprecation

Везде, где настроен `warn_error_options`, замените:

* `include` на `error`
* `exclude` на `warn`

Например:

```yaml
...
  flags:
    warn_error_options:
      include:
        - NoNodesForSelectionCriteria
```

Теперь это нужно настраивать так:

```yaml
...
  flags:
    warn_error_options:
      error:
        - NoNodesForSelectionCriteria
```
