Устаревающие возможности
Устаревшая функциональность по-прежнему работает в версии v1.10, но больше не поддерживается и будет удалена в одной из будущих версий. Сейчас сообщения об устаревшей функциональности отображаются как предупреждения и не препятствуют выполнению запусков и других команд (если вы не настроили обработку предупреждений как ошибок), но после обновления они приведут к ошибкам, если не устранить их причины.
Это не то же самое, что флаги изменения поведения (флаги в файле dbt_project.yml, позволяющие включать или отключать изменения поведения) или устаревшие флаги CLI (флаги командной строки, которые удаляются в dbt v2). Краткое сравнение см. в разделе Обзор изменений.
Переходите на dbt v2? Перед обновлением необходимо устранить все случаи использования устаревшей функциональности, перечисленные на этой странице.
Во время работы dbt генерирует различные категории событий, одна из которых — сообщения об устаревшей функциональности. Это особый тип предупреждений, сообщающих о проблемах в отдельных частях вашего проекта, которые приведут к несовместимым изменениям в одной из будущих версий dbt. Хотя пока это лишь предупреждения, важно устранить причины всех таких предупреждений в проекте, чтобы в дальнейшем работать безопаснее и увереннее, получая своевременную обратную связь.
Определение предупреждений об устаревании
Поиск устареваний в стандартных логах может быть сложной задачей. Однако выявление таких предупреждений — первый шаг к их устранению. Существует несколько способов быстро найти устаревания и автоматически исправить некоторые из них.
dbt CLI
Чтобы просмотреть устаревания через CLI, выполните команду:
dbt parse --no-partial-parse --show-all-deprecations
Флаг --no-partial-parse гарантирует, что будут включены даже те устаревания, которые обнаруживаются только на этапе парсинга. Флаг --show-all-deprecations обеспечивает вывод каждого случая устаревания, а не только первого.
dbt parseПри использовании dbt v2 уберите --no-partial-parse из команды выше. Этот флаг устарел в dbt v2 и может вызвать предупреждение dbt1700. Запустите dbt parse --show-all-deprecations без --no-partial-parse.
Подробнее см. Устаревшие флаги в руководстве по переходу на dbt v2.
19:15:13 [WARNING]: Deprecated functionality
Summary of encountered deprecations:
- MFTimespineWithoutYamlConfigurationDeprecation: 1 occurrence
Платформа dbt
Если вы используете dbt, вы можете просмотреть предупреждения об устаревании в разделе Dashboard вашей учетной записи.
Откройте задание, чтобы просмотреть подробную информацию и найти предупреждения об устаревании в логах (или выполните команду parse с флагами в Studio IDE или dbt platform CLI).
Автоматическое исправление
Некоторые проблемы, связанные с устаревшими возможностями, можно автоматически исправить с помощью скрипта. Подробнее об этом читайте в этой статье блога dbt. Скачайте скрипт и следуйте инструкциям по установке, чтобы начать работу.
Вы можете запустить этот скрипт непосредственно из Studio IDE с помощью кнопки Autofix warnings, чтобы устранить предупреждения об устаревших возможностях в dbt platform.
Используйте кнопку Autofix warnings в Studio IDE, чтобы устранить предупреждения об устаревших возможностях в dbt platform.Подавление предупреждений об устаревших возможностях
dbt Labs рекомендует устранять причины предупреждений об устаревших возможностях, а не подавлять их. Если вам нужно временно уменьшить количество лишних сообщений в логах, используйте --warn-error-options с параметром silence. Это работает с любой командой dbt, включая dbt test и dbt parse.
Полный список вариантов настройки (флаг CLI, переменная окружения и dbt_project.yml) приведён в разделе Предупреждения.
Чтобы подавить все предупреждения об устаревших возможностях в dbt v1:
dbt test --warn-error-options '{"silence": ["Deprecations"]}'
В dbt v2 поведение отличается от dbt v1:
- Группа
Deprecationsможет подавлять не все предупреждения, связанные с устаревшими возможностями. Предпочтительно указывать конкретное имя события из логов (например,SemanticModelDeprecated). - Некоторые устаревшие настройки в dbt v2 вызывают ошибки, которые нельзя подавить. Такие настройки необходимо исправить.
Подробнее о том, как dbt v2 обрабатывает warn_error_options, о поддерживаемых именах и случаях возникновения ошибок, которые нельзя подавить, читайте в разделе Поведение dbt v2 и коды предупреждений.
Ниже приведены предупреждения об устаревании, существующие в dbt на текущий момент, а также версии, в которых они появились впервые.
ArgumentsPropertyInGenericTestDeprecation
dbt объявил устаревшей возможность указывать пользовательское свойство верхнего уровня с именем arguments в generic-тестах. Это предупреждение возникает только в том случае, если флаг поведения require_generic_test_arguments_property установлен в False.
В dbt объявлена устаревшей возможность указывать пользовательское свойство верхнего уровня с именем arguments в универсальных тестах. Это предупреждение об устаревании выводится только в том случае, если флаг поведения require_generic_test_arguments_property установлен в false.
Ранее в пользовательских generic-тестах могло использоваться свойство arguments:
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:
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, чтобы конфигурация была синтаксически корректной. Например:
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 параметр data-paths был переименован в seed-paths. Если вы получаете это предупреждение об устаревшем параметре, значит, в файле dbt_project.yml вашего проекта всё ещё используется data-paths.
Пример предупреждения:
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 указание log-path в dbt_project.yml было объявлено устаревшим. Это предупреждение об устаревании означает, что в вашем файле dbt_project.yml по-прежнему указан параметр log-path и его значение отличается от значения по умолчанию — logs.
Пример:
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, как описано здесь.
ConfigSourcePathDeprecation
В dbt v1.0 параметр source-paths был переименован в model-paths. Это предупреждение об устаревшем параметре означает, что в файле dbt_project.yml вашего проекта всё ещё используется source-paths.
Пример:
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 указание target-path в dbt_project.yml было объявлено устаревшим. Это предупреждение об устаревании означает, что target-path по-прежнему указан в вашем dbt_project.yml и его значение отличается от значения по умолчанию — target.
Пример:
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.
CustomKeyInConfigDeprecation
Это предупреждение возникает, когда вы используете пользовательские (custom) ключи конфигурации, которые dbt не распознаёт как часть официальной спецификации конфигураций. Это относится к конфигурационным блокам как в SQL-, так и в YAML‑файлах.
Пример, который приводит к предупреждению:
models:
- name: my_model
config:
custom_config_key: value
Как устранить предупреждение CustomKeyInConfigDeprecation
Поместите пользовательские ключи под meta и убедитесь, что meta вложен под config (аналогично PropertyMovedToConfigDeprecation). Например:
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).
Один и тот же способ решения применим независимо от того, где указан пользовательский ключ: в конфигурации модели или в определении универсального теста. Выберите соответствующую вкладку, чтобы посмотреть пример:
- Конфигурация модели
- Определение универсального теста
Пример, при котором возникает предупреждение:
models:
- name: my_model
config:
custom_config_key: value
columns:
- name: my_column
meta:
some_key: some_value
Пример решения:
models:
- name: my_model
config:
meta:
custom_config_key: value
columns:
- name: my_column
config:
meta:
some_key: some_value
Если вы определяете пользовательский ключ непосредственно под тестом в блоке tests:, поместите его в config.meta.
Пример, вызывающий предупреждение:
tests:
- name: custom_generic_test
description: My custom generic test
arguments:
- name: active_timestamp
type: timestamp
description: The active timestamp for the model
Пример исправления:
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:
{% set my_custom_config = config.get('custom_config_key') %}
После того как конфигурации будут вложены:
{% 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:
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:
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. Подробнее см. в разделе Уникальные имена ресурсов проекта.
Как устранить предупреждение DuplicateNameDistinctNodeTypesDeprecation
Переименуйте один из конфликтующих ресурсов, чтобы все имена были уникальными.
DuplicateYAMLKeysDeprecation
Это предупреждение возникает, когда в profiles.yml существуют два одинаковых ключа.
Ранее, если в файле profiles.yml встречались одинаковые ключи, dbt использовал последнюю конфигурацию, указанную в файле.
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, в свойстве name экспозиций допускаются только буквы, цифры и символы подчёркивания.
Пример:
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 у exposures.
GenerateSchemaNameNullValueDeprecation
dbt выводит это предупреждение об устаревшем поведении, когда пользовательский макрос generate_schema_name возвращает значение null. Возврат null вместо имени схемы может привести к некорректному или непредсказуемому поведению.
Это предупреждение об устаревшем поведении выводится, когда флаг require_valid_schema_from_generate_schema_name установлен в false. Когда флаг установлен в true, dbt выдаёт ошибку на этапе разбора.
Устранение предупреждения GenerateSchemaNameNullValueDeprecation
Если в вашем проекте определён макрос generate_schema_name, обновите его так, чтобы он возвращал допустимое имя схемы. Например:
{% 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
Если вы видите это предупреждение, к сожалению, на данный момент вы мало что можете сделать, но мы продолжаем работать над тем, чтобы предупреждения об использовании устаревших возможностей появлялись реже. Если вам нужны рекомендации по конкретному случаю, с которым вы столкнулись, обратитесь в службу поддержки (для клиентов облачной платформы dbt) или в Slack-сообщество (для пользователей dbt v1).
MFCumulativeTypeParamsDeprecation
В dbt v1.9 указание window и time_to_grain непосредственно в type_params метрики было объявлено устаревшим.
Пример:
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 в dbt появилось определение временной шкалы в YAML для MetricFlow. Впоследствии было решено сделать этот способ стандартным для дальнейшего использования. Если вы видите это предупреждение об устаревании, у вас отсутствует определение временной шкалы в YAML для MetricFlow.
Пример:
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.
MissingArgumentsPropertyInGenericTestDeprecation
В dbt объявлено устаревшим указание именованных аргументов в качестве свойств пользовательских обобщённых тестов данных или тестов данных, использующих альтернативный формат test_name. Вместо этого аргументы тестов следует указывать в новом свойстве arguments.
Это предупреждение об устаревании выводится только в том случае, если флаг поведения require_generic_test_arguments_property установлен в true.
Как устранить предупреждение MissingArgumentsPropertyInGenericTestDeprecation
Если ранее вы задавали аргументы как свойства верхнего уровня в пользовательских generic tests:
models:
- name: my_model_with_generic_test
data_tests:
- dbt_utils.expression_is_true:
expression: "order_items_subtotal = subtotal"
Или при использовании альтернативного формата test_name:
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:
models:
- name: my_model_with_generic_test
data_tests:
- dbt_utils.expression_is_true:
arguments:
expression: "order_items_subtotal = subtotal"
Или с конфигурациями фреймворка:
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 объявил устаревшим указание конфигураций без префикса + в файле dbt_project.yml. Теперь только имена папок и файлов могут указываться без префикса + внутри конфигураций ресурсов в dbt_project.yml.
Пример:
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:
models:
marts:
materialized: table
Теперь вам нужно задавать её с префиксом +, чтобы однозначно различать пути:
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.
Пример:
15:49:33 [WARNING]: Deprecated functionality
Usage of itertools modules is deprecated. Please use the built-in functions
instead.
Как устранить предупреждение ModulesItertoolsUsageDeprecation
Если вы сейчас используете функции из модуля itertools в SQL-шаблонах Jinja, используйте вместо них доступные встроенные функции dbt и методы Jinja.
Например, следующий 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. Например:
{%- 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 -%}
{%- 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 в dbt_project.yml, хотя dbt_modules не является значением packages-install-path.
Пример:
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
Рекомендуемые подходы:
- Замените
dbt_modulesнаdbt_packagesв спецификацииclean-targets(и в.gitignore). - Установите
packages-install-path: dbt_modules, если вы хотите продолжать устанавливать пакеты вdbt_modules.
PackageMaterializationOverrideDeprecation
Поведение, при котором установленные пакеты могли переопределять встроенные материализации без вашего явного согласия, объявлено устаревшим. Установка флага require_explicit_package_overrides_for_builtin_materializations в значение false в файле dbt_project.yml позволяла материализациям из пакетов, имена которых совпадали с именами встроенных материализаций, по-прежнему учитываться при поиске и определении используемой материализации.
Как устранить предупреждение PackageMaterializationOverrideDeprecation
Явно переопределите встроенные материализации в пользу материализации, определённой в пакете: переимплементируйте встроенную материализацию в вашем корневом проекте и оберните реализацию из пакета.
Например:
{% 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.
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.
Пример:
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 из profiles.yml в flags в dbt_project.yml.
PropertyMovedToConfigDeprecation
Некоторые прежние свойства полностью переносятся в параметры конфигурации.
Сюда входят: freshness, meta, tags, docs, group и access.
Перевод некоторых properties в configs полезен тем, что вы можете задавать их сразу для многих ресурсов в dbt_project.yml (дефолты на уровне проекта/папок). Подробнее о разнице между properties и configs — здесь.
Как устранить предупреждение PropertyMovedToConfigDeprecation
Если ранее вы задавали одно из затронутых properties, например freshness:
sources:
- name: ecom
schema: raw
description: E-commerce data for the Jaffle Shop
freshness:
warn_after:
count: 24
period: hour
Теперь вам нужно задавать это под config:
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 использование пробелов в именах ресурсов было объявлено устаревшим. Если вы видите это предупреждение об устаревании, значит dbt обнаружил имя ресурса с пробелом.
Пример:
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 (документация). Ранее при выполнении dbt source freshness хуки проекта не запускались для источников.
Пример:
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 см. в документации по изменению поведения.
SourceOverrideDeprecation
Свойство overrides для sources признано устаревшим.
Это предупреждение об устаревании (deprecation warning) выводится только для следующих адаптеров:
- Snowflake
- Databricks
- BigQuery
- Redshift
Как устранить предупреждение SourceOverrideDeprecation
Удалите свойство overrides и вместо этого включайте или отключайте source из пакета.
UnexpectedJinjaBlockDeprecation
Если у вас есть неожиданный Jinja‑блок — «сиротский» Jinja‑блок или Jinja‑блок вне контекста макроса — вы получите предупреждение, и в будущей версии dbt перестанет поддерживать неожиданные Jinja‑блоки. Ранее такие Jinja‑блоки «тихо» игнорировались.
{% endmacro %} # orphaned endmacro jinja block
{% macro hello() %}
hello!
{% endmacro %}
Как устранить предупреждение UnexpectedJinjaBlockDeprecation
Удалите неожиданные Jinja‑блоки.
WEOIncludeExcludeDeprecation
Опции include и exclude для warn_error_options признаны устаревшими и заменены на error и warn соответственно.
Как устранить предупреждение WEOIncludeExcludeDeprecation
Везде, где настроен warn_error_options, замените:
includeнаerrorexcludeнаwarn
Например:
...
flags:
warn_error_options:
include:
- NoNodesForSelectionCriteria
Теперь это нужно настраивать так:
...
flags:
warn_error_options:
error:
- NoNodesForSelectionCriteria

