version

Версии моделей, версии dbt_project.yml и версии .yml

Слово «version» встречается в документации в нескольких местах и используется в разных значениях:

• Model versions — функция dbt Mesh, которая обеспечивает более эффективное управление и контроль моделей данных, позволяя отслеживать изменения и обновления моделей с течением времени.
• dbt_project.yml version (опционально) — версия dbt_project.yml не связана с Mesh и указывает на совместимость dbt-проекта с конкретной версией dbt.
• .yml property file version (опционально) — номера версий в .yml-файлах свойств определяют, как dbt интерпретирует эти YAML-файлы. Не связано с Mesh.

В dbt проектах существуют два различных типа тегов version. Это поле имеет разное значение в зависимости от его расположения.

Версии в dbt_project.yml

Тег версии в файле dbt_project представляет версию вашего dbt проекта.

Начиная с версии dbt 1.5, version в dbt_project.yml является необязательным параметром. Если он используется, версия должна быть в формате семантического версионирования, например, 1.0.0. Значение по умолчанию — None, если не указано. Для пользователей на версии dbt 1.4 или ниже этот тег обязателен, хотя в настоящее время он не используется dbt значимо.

Начиная с версии dbt 1.5, параметр version в файле dbt_project.yml является необязательным. Если он используется, значение версии должно быть указано в формате семантического версионирования, например 1.0.0. Если параметр не задан, по умолчанию используется значение None. Для пользователей dbt версии 1.4 и ниже этот параметр является обязательным, хотя в настоящее время dbt не использует его каким-либо значимым образом.

Подробнее о версиях Core см. в разделе About dbt Core versions.

dbt_project.yml

version: version

Версии файлов свойств .yml

Тег версии в файле свойств .yml предоставляет управляющий тег, который информирует, как dbt обрабатывает файлы свойств.

Начиная с версии 1.5, dbt больше не будет требовать этой конфигурации в ваших ресурсных файлах .yml. Если вы хотите узнать больше о том, почему этот тег ранее был необходим, вы можете обратиться к Часто задаваемым вопросам. Для пользователей на версии dbt 1.4 или ниже этот тег обязателен.

Подробнее о файлах свойств см. их общую документацию на этой же странице.

Файл свойств ресурса с указанной версией

<any valid filename>.yml

version: 2  # Только 2 принимается dbt версиями до 1.4.latest.

models: 
    ...

Файл свойств ресурса без указанной версии

<any valid filename>.yml

models: 
    ...

ЧАВО

Почему файлы YAML для моделей и источников всегда начинаются с `version: 2`?

Когда‑то структура этих файлов .yml была совсем другой (привет всем, кто пользовался dbt в те времена!). Добавление version: 2 позволило нам сделать эту структуру более расширяемой.

Начиная с dbt Core v1.5, ключ верхнего уровня version: является необязательным во всех ресурсных YAML‑файлах. Если он указан, поддерживается только version: 2.

Также, начиная с версии 1.5, и config-version: 2, и ключ верхнего уровня version: в файле dbt_project.yml являются необязательными.

В настоящее время ресурсные YAML‑файлы не требуют наличия этой настройки. Если она указана, мы поддерживаем только version: 2. Хотя мы не ожидаем в ближайшее время обновлять YAML‑файлы до version: 3, наличие этой конфигурации упростит для нас внедрение новых структур в будущем.

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

Создать GitHub Issue