Об изменениях поведения
Изменение поведения — это намеренное обновление dbt, после которого тот же код проекта и те же команды дают другой результат. Например, появляется новая ошибка валидации, меняется сигнатура макроса или нарушается совместимость артефактов или структурированных журналов. Исправления ошибок, новые предупреждения и обратно совместимые дополнения к таким изменениям не относятся.
dbt вводит эти изменения с помощью флагов изменения поведения, чтобы вы могли сами решать, когда переходить на новое поведение.
Примеры изменений поведения:
- dbt начинает выдавать ошибку валидации, которую раньше не выдавал.
- dbt изменяет сигнатуру встроенного макроса. В вашем проекте есть собственная реализация этого макроса. Это может привести к ошибкам, поскольку в вашу реализацию будут передаваться аргументы, которые она не может принять.
- Адаптер dbt переименовывает или удаляет метод, который ранее был доступен у объекта
{{ adapter }}в контексте dbt-Jinja.
Следующие изменения не считаются изменениями поведения:
- Исправление ошибки, из-за которой прежнее поведение было некорректным, нежелательным или недокументированным.
- dbt начинает выдавать предупреждение, которое раньше не выдавал.
- dbt обновляет формулировки сообщений для пользователей в событиях журнала.
Флаги изменений в поведении
Эти флаги должны быть установлены в словаре flags в dbt_project.yml. Они настраивают поведение, тесно связанное с кодом проекта, что означает, что они должны быть определены в системе контроля версий и изменены через pull или merge запросы с тем же тестированием и рецензированием.
Жизненный цикл флагов
Флаги изменения поведения проходят три этапа развития:
- Введение (отключён по умолчанию): dbt добавляет логику для поддержки как «старого», так и «нового» поведения. «Новое» поведение управляется флагом, который по умолчанию отключён, что сохраняет старое поведение.
- Зрелость (включён по умолчанию): Значение флага по умолчанию меняется, и новое поведение становится поведением по умолчанию. Вы по-прежнему можете сохранить старое поведение, но при этом могут появляться предупреждения о прекращении его поддержки.
- Удаление (новое поведение включено всегда): Старое поведение удаляется из кодовой базы dbt. Большинство флагов поддерживаются бессрочно, но обязательств поддерживать их вечно нет. Об удалении флага будет объявлено заблаговременно.
Введены в dbt v1
В этой таблице указано, в каком месяце в канале выпусков v1 Latest в dbt и в какой версии dbt v1 изменение поведения было введено (отключено по умолчанию) или достигло зрелости (включено по умолчанию). Флаги, отмеченные значением 2.0 в столбце Удаление, удалены в dbt v2, и новое поведение включено всегда.
Введены в dbt v2
Следующие флаги предназначены только для dbt v2 и не имеют аналогов в dbt v1. Они настраиваются так же — в блоке flags: файла dbt_project.yml.
| Флаг | Адаптер | Значение по умолчанию | Введение | Становится значением по умолчанию |
|---|---|---|---|---|
| require_resource_names_without_plus_prefix | Все | false | 2.0.0-preview.208 | Пока не определено |
| use_catalogs_v2 | Все | 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 | Databricks 1.9.0 | - | 2.0 |
| use_user_folder_for_python | Databricks 1.9.0 | - | 2.0 |
| use_managed_iceberg | Databricks 1.11.0 | 1.12.0 | - |
| use_materialization_v2 | Databricks 1.10.0 | - | - |
| use_replace_on_for_insert_overwrite | Databricks 1.11.0 | 1.11.0 | - |
| use_describe_as_json_for_relation_metadata | Databricks 1.12.0 | - | - |
| redshift_skip_autocommit_transaction_statements | Redshift 1.12.0 | - | - |
| bigquery_use_batch_source_freshness | BigQuery 1.11.0rc2 | - | - |
| bigquery_reject_wildcard_metadata_source_freshness | BigQuery 1.12.0 | - | - |
| bigquery_use_standard_sql_for_partitions | BigQuery 1.12.0 | 1.12.0 | - |
| snowflake_default_transient_dynamic_tables | Snowflake 1.12.0 | - | - |