Перейти к основному содержимому

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

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

Устаревшая функциональность по-прежнему работает в версии 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: v2.0 и новее)
dbt v2 и 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 вашей учетной записи.

Предупреждения об устаревании на панели управления dbt.Предупреждения об устаревании на панели управления dbt.

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

Предупреждения об устаревании в логах.Предупреждения об устаревании в логах.

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

Некоторые проблемы, связанные с устаревшими возможностями, можно автоматически исправить с помощью скрипта. Подробнее об этом читайте в этой статье блога dbt. Скачайте скрипт и следуйте инструкциям по установке, чтобы начать работу.

Вы можете запустить этот скрипт непосредственно из Studio IDE с помощью кнопки Autofix warnings, чтобы устранить предупреждения об устаревших возможностях в dbt platform.

Используйте кнопку 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) приведён в разделе Предупреждения.

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

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 и коды предупреждений.

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

ArgumentsPropertyInGenericTestDeprecation​

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

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

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

model.yml
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
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
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.

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

CLI
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.

Пример:

CLI
(Версии dbt: v1.11 и новее)
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.

Пример:

CLI
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.

Пример:

CLI
(Версии dbt: v1.11 и новее)
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

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

Чтобы получить доступ к пользовательским конфигурациям, вложенным в атрибуты 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:

dbt_project.yml
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
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 использовал последнюю конфигурацию, указанную в файле.

profiles.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, в свойстве name экспозиций допускаются только буквы, цифры и символы подчёркивания.

Пример:

CLI
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, обновите его так, чтобы он возвращал допустимое имя схемы. Например:

macros/get_custom_schema.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​

Если вы видите это предупреждение, к сожалению, на данный момент вы мало что можете сделать, но мы продолжаем работать над тем, чтобы предупреждения об использовании устаревших возможностей появлялись реже. Если вам нужны рекомендации по конкретному случаю, с которым вы столкнулись, обратитесь в службу поддержки (для клиентов облачной платформы dbt) или в Slack-сообщество (для пользователей dbt v1).

MFCumulativeTypeParamsDeprecation​

В dbt v1.9 указание window и time_to_grain непосредственно в type_params метрики было объявлено устаревшим.

Пример:

CLI
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.

Пример:

CLI
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:

model.yml
models:
- name: my_model_with_generic_test
data_tests:
- dbt_utils.expression_is_true:
expression: "order_items_subtotal = subtotal"

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

model.yml
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
models:
- name: my_model_with_generic_test
data_tests:
- dbt_utils.expression_is_true:
arguments:
expression: "order_items_subtotal = subtotal"

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

model.yml
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.

Пример:

CLI
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
models: 
marts:
materialized: table

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

dbt_project.yml
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
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‑файл:

models/itertools_usage.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
{%- 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
{%- 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.

Пример:

CLI
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 в значение 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.

CLI
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
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 обнаружил имя ресурса с пробелом.

Пример:

CLI
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 хуки проекта не запускались для источников.

Пример:

CLI
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‑блоки «тихо» игнорировались.

macros/my_macro.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

Например:

...
flags:
warn_error_options:
include:
- NoNodesForSelectionCriteria

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

...
flags:
warn_error_options:
error:
- NoNodesForSelectionCriteria

Нашли ошибку?

0
Loading