# Об изменениях поведения

Изменение поведения — это намеренное обновление dbt, после которого тот же код проекта и те же команды дают другой результат. Например, появляется новая ошибка валидации, меняется сигнатура макроса или нарушается совместимость артефактов или структурированных журналов. Исправления ошибок, новые предупреждения и обратно совместимые дополнения к таким изменениям не относятся.

dbt вводит эти изменения с помощью флагов изменения поведения, чтобы вы могли сами решать, когда переходить на новое поведение.

Примеры изменений поведения:

* dbt начинает выдавать *ошибку* валидации, которую раньше не выдавал.
* dbt изменяет сигнатуру встроенного макроса. В вашем проекте есть собственная реализация этого макроса. Это может привести к ошибкам, поскольку в вашу реализацию будут передаваться аргументы, которые она не может принять.
* Адаптер dbt переименовывает или удаляет метод, который ранее был доступен у объекта `{{ adapter }}` в контексте dbt-Jinja.

Следующие изменения *не считаются* изменениями поведения:

* Исправление ошибки, из-за которой прежнее поведение было некорректным, нежелательным или недокументированным.
* dbt начинает выдавать *предупреждение*, которое раньше не выдавал.
* dbt обновляет формулировки сообщений для пользователей в событиях журнала.

## Флаги изменений в поведении

Эти флаги *должны* быть установлены в словаре `flags` в `dbt_project.yml`. Они настраивают поведение, тесно связанное с кодом проекта, что означает, что они должны быть определены в системе контроля версий и изменены через pull или merge запросы с тем же тестированием и рецензированием.

### Жизненный цикл флагов

Флаги изменения поведения проходят три этапа развития:

1. **Введение (отключён по умолчанию):** dbt добавляет логику для поддержки как «старого», так и «нового» поведения. «Новое» поведение управляется флагом, который по умолчанию отключён, что сохраняет старое поведение.
2. **Зрелость (включён по умолчанию):** Значение флага по умолчанию меняется, и новое поведение становится поведением по умолчанию. Вы по-прежнему можете сохранить старое поведение, но при этом могут появляться предупреждения о прекращении его поддержки.
3. **Удаление (новое поведение включено всегда):** Старое поведение удаляется из кодовой базы dbt. Большинство флагов поддерживаются бессрочно, но обязательств поддерживать их вечно нет. Об удалении флага будет объявлено заблаговременно.

### Введены в dbt v1

В этой таблице указано, в каком месяце в канале выпусков **v1 Latest** в dbt и в какой версии dbt v1 изменение поведения было введено (отключено по умолчанию) или достигло зрелости (включено по умолчанию). Флаги, отмеченные значением 2.0 в столбце **Удаление**, удалены в dbt v2, и новое поведение включено всегда.

| Флаг                                                                                                                                                                                                          | **v1 Latest**: Введение | **v1 Latest**: Зрелость | dbt v1: Введение | dbt v1: Зрелость | Удаление |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ----------------------- | ---------------- | ---------------- | -------- |
| [require\_explicit\_package\_overrides\_for\_builtin\_materializations](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_explicit_package_overrides_for_builtin_materializations.md) | 2024.04                 | 2024.06                 | 1.6.14, 1.7.14   | 1.8.0            | 2.0      |
| [require\_resource\_names\_without\_spaces](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_resource_names_without_spaces.md)                                                       | 2024.05                 | 2025.05                 | 1.8.0            | 1.10.0           | 2.0      |
| [source\_freshness\_run\_project\_hooks](https://docs.getdbt.tech/reference/global-configs/behavior-flags/source_freshness_run_project_hooks.md)                                                             | 2024.03                 | 2025.05                 | 1.8.0            | 1.10.0           | 2.0      |
| [skip\_nodes\_if\_on\_run\_start\_fails](https://docs.getdbt.tech/reference/global-configs/behavior-flags/skip_nodes_if_on_run_start_fails.md)                                                               | 2024.10                 | 2026.09                 | 1.9.0            | 1.12.0           | 2.0      |
| [state\_modified\_compare\_more\_unrendered\_values](https://docs.getdbt.tech/reference/global-configs/behavior-flags/state_modified_compare_more_unrendered_values.md)                                      | 2024.10                 | 2026.09                 | 1.9.0            | 1.12.0           | 2.0      |
| [require\_yaml\_configuration\_for\_mf\_time\_spines](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_yaml_configuration_for_mf_time_spines.md)                                     | 2024.10                 | 2026.09                 | 1.9.0            | 1.12.0           | 2.0      |
| [require\_batched\_execution\_for\_custom\_microbatch\_strategy](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_batched_execution_for_custom_microbatch_strategy.md)               | 2024.11                 | 2026.09                 | 1.9.0            | 1.12.0           | 2.0      |
| [require\_nested\_cumulative\_type\_params](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_nested_cumulative_type_params.md)                                                       | 2024.11                 | 2026.09                 | 1.9.0            | 1.12.0           | 2.0      |
| [enable\_truthy\_nulls\_equals\_macro](https://docs.getdbt.tech/reference/global-configs/behavior-flags/enable_truthy_nulls_equals_macro.md)                                                                 | 2025.02                 | -                       | 1.9.0            | -                | -        |
| [validate\_macro\_args](https://docs.getdbt.tech/reference/global-configs/behavior-flags/validate_macro_args.md)                                                                                             | 2025.03                 | 2026.09                 | 1.10.0           | 1.12.0           | -        |
| [require\_all\_warnings\_handled\_by\_warn\_error](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_all_warnings_handled_by_warn_error.md)                                           | 2025.06                 | 2026.09                 | 1.10.0           | 1.12.0           | -        |
| [require\_generic\_test\_arguments\_property](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_generic_test_arguments_property.md)                                                   | 2025.07                 | 2025.08                 | 1.10.5           | 1.10.8           | -        |
| [require\_unique\_project\_resource\_names](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_unique_project_resource_names.md)                                                       | 2025.12                 | -                       | 1.11.0           | -                | -        |
| [require\_ref\_searches\_node\_package\_before\_root](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_ref_searches_node_package_before_root.md)                                     | 2025.12                 | -                       | 1.11.0           | -                | -        |
| [require\_valid\_schema\_from\_generate\_schema\_name](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_valid_schema_from_generate_schema_name.md)                                   | 2026.1                  | -                       | 1.12.0a1         | -                | -        |
| [require\_sql\_header\_in\_test\_configs](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_sql_header_in_test_configs.md)                                                            | 2026.3                  | -                       | 1.12.0           | -                | -        |
| [require\_corrected\_analysis\_fqns](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_corrected_analysis_fqns.md)                                                                    | 2026.3                  | -                       | 1.12.0           | -                | -        |
| [require\_source\_and\_semantic\_model\_names\_without\_spaces](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_source_and_semantic_model_names_without_spaces.md)                  | 2026.4                  | -                       | 1.12.0           | -                | -        |
| [allow\_jinja\_file\_extensions](https://docs.getdbt.tech/reference/global-configs/behavior-flags/allow_jinja_file_extensions.md)                                                                            | 2026.5                  | -                       | 1.12.0           | -                | -        |
| [latest\_version\_pointer\_enabled\_by\_default](https://docs.getdbt.tech/reference/global-configs/behavior-flags/latest_version_pointer_enabled_by_default.md)                                              | 2026.5                  | -                       | 1.12.0           | -                | -        |

### Введены в dbt v2

Следующие флаги предназначены только для dbt v2 и не имеют аналогов в dbt v1. Они настраиваются так же — в блоке `flags:` файла `dbt_project.yml`.

| Флаг                                                                                                                                                               | Адаптер  | Значение по умолчанию | Введение           | Становится значением по умолчанию |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | --------------------- | ------------------ | --------------------------------- |
| [require\_resource\_names\_without\_plus\_prefix](https://docs.getdbt.tech/reference/global-configs/behavior-flags/require_resource_names_without_plus_prefix.md) | Все      | `false`               | 2.0.0-preview\.208 | Пока не определено                |
| [use\_catalogs\_v2](https://docs.getdbt.tech/docs/build/iceberg/catalogs-yml.md?version=2#new-spec-recommended-)                                                  | Все      | `true`                | 2.0.0-preview\.174 | 2.0.0                             |
| bigquery\_noop\_alter\_relation\_comment                                                                                                                           | BigQuery | `false`               | 2.0.0-preview\.124 | Пока не определено                |

### Флаги изменения поведения для отдельных адаптеров

В этой таблице указано, в какой версии адаптера dbt изменение поведения было введено (отключено по умолчанию) или достигло зрелости (включено по умолчанию). Флаги, отмеченные значением 2.0 в столбце **Удаление**, удалены в dbt v2, и новое поведение включено всегда.

| Флаг                                                                                                                                                                                          | dbt-ADAPTER: Введение | dbt-ADAPTER: Зрелость | Удаление |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | --------------------- | -------- |
| [use\_info\_schema\_for\_columns](https://docs.getdbt.tech/reference/global-configs/databricks-changes.md#use-information-schema-for-columns)                                                | Databricks 1.9.0      | -                     | 2.0      |
| [use\_user\_folder\_for\_python](https://docs.getdbt.tech/reference/global-configs/databricks-changes.md#use-users-folder-for-python-model-notebooks)                                        | Databricks 1.9.0      | -                     | 2.0      |
| [use\_managed\_iceberg](https://docs.getdbt.tech/reference/global-configs/databricks-changes.md#use-managed-iceberg)                                                                         | Databricks 1.11.0     | 1.12.0                | -        |
| [use\_materialization\_v2](https://docs.getdbt.tech/reference/global-configs/databricks-changes.md#use-restructured-materializations)                                                        | Databricks 1.10.0     | -                     | -        |
| [use\_replace\_on\_for\_insert\_overwrite](https://docs.getdbt.tech/reference/global-configs/databricks-changes.md#use-replace-on-for-insert_overwrite-strategy)                             | Databricks 1.11.0     | 1.11.0                | -        |
| [use\_describe\_as\_json\_for\_relation\_metadata](https://docs.getdbt.tech/reference/global-configs/databricks-changes.md#use-describe-as-json-for-relation-metadata)                       | Databricks 1.12.0     | -                     | -        |
| [redshift\_skip\_autocommit\_transaction\_statements](https://docs.getdbt.tech/reference/global-configs/redshift-changes.md#redshift_skip_autocommit_transaction_statements-flag)            | Redshift 1.12.0       | -                     | -        |
| [bigquery\_use\_batch\_source\_freshness](https://docs.getdbt.tech/reference/global-configs/bigquery-changes.md#the-bigqueryusebatchsourcefreshness-flag)                                    | BigQuery 1.11.0rc2    | -                     | -        |
| [bigquery\_reject\_wildcard\_metadata\_source\_freshness](https://docs.getdbt.tech/reference/global-configs/bigquery-changes.md#the-bigquery_reject_wildcard_metadata_source_freshness-flag) | BigQuery 1.12.0       | -                     | -        |
| [bigquery\_use\_standard\_sql\_for\_partitions](https://docs.getdbt.tech/reference/global-configs/bigquery-changes.md#the-bigquery_use_standard_sql_for_partitions-flag)                     | BigQuery 1.12.0       | 1.12.0                | -        |
| [snowflake\_default\_transient\_dynamic\_tables](https://docs.getdbt.tech/reference/global-configs/snowflake-changes.md#the-snowflake_default_transient_dynamic_tables-flag)                 | Snowflake 1.12.0      | -                     | -        |

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

 Как настроить флаги изменения поведения в моём проекте?

В следующем примере показаны текущие флаги и их текущие значения по умолчанию в последних версиях dbt и dbt v1. Чтобы отказаться от определённого изменения поведения, задайте для соответствующего флага значение `false` в `dbt_project.yml`. Предупреждения об использовании устаревшего поведения, сохранённого при отказе от изменений, будут появляться до тех пор, пока вы не выполните одно из следующих действий:

* Устраните проблему (переключив флаг на `true`)
* Отключите предупреждения с помощью флага `warn_error_options.silence`

dbt\_project.yml

```yml
flags:
  require_explicit_package_overrides_for_builtin_materializations: true
  require_resource_names_without_spaces: true
  source_freshness_run_project_hooks: true
  skip_nodes_if_on_run_start_fails: true
  state_modified_compare_more_unrendered_values: true
  require_yaml_configuration_for_mf_time_spines: true
  require_batched_execution_for_custom_microbatch_strategy: true
  require_nested_cumulative_type_params: true
  validate_macro_args: true
  require_all_warnings_handled_by_warn_error: true
  require_generic_test_arguments_property: true
  require_unique_project_resource_names: false
  require_ref_searches_node_package_before_root: false
  require_valid_schema_from_generate_schema_name: false
  enable_truthy_nulls_equals_macro: false
  require_sql_header_in_test_configs: false
  require_corrected_analysis_fqns: false
  require_source_and_semantic_model_names_without_spaces: false
  allow_jinja_file_extensions: false
  latest_version_pointer_enabled_by_default: false
```

 Что означает отсутствие даты погашения?

Если дата вступления в силу ещё не назначена (в таблице стоит прочерк), точная дата смены значения флага по умолчанию пока неизвестна. До этого пользователи будут видеть предупреждения об устаревании и заранее получат уведомление по электронной почте. Если вы видите такое предупреждение, можно:

* Обновить проект для работы с новым поведением и установить флаг в `true`, чтобы отключить предупреждения.
* Явно установить флаг в `false`. Предупреждения останутся, но прежнее поведение сохранится даже после смены значения флага по умолчанию.

 Чем флаги изменения поведения отличаются от других изменений?

Флаги изменения поведения следует отличать от других изменений dbt:

* [Предупреждения об устаревании](https://docs.getdbt.tech/reference/deprecations.md) сообщают о конструкциях в коде проекта, которые перестанут работать. Флаги поведения часто определяют, когда такие предупреждения станут ошибками.
* [Устаревшие флаги CLI](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v2.md#deprecated-flags) — параметры командной строки, которые удаляются в v2.

Краткое сравнение приведено в разделе [Обзор изменений](https://docs.getdbt.tech/reference/changes-overview.md).

Если вы переходите на [v2](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v2.md), некоторые флаги изменения поведения удалены, а соответствующее им новое поведение всегда включено.
