version

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

Обратите внимание, что версии моделей отличаются от версий dbt_project.yml и версий файлов свойств .yml.

Версии моделей — это функция, которая позволяет улучшить управление и контроль моделей данных, позволяя отслеживать изменения и обновления моделей с течением времени. Версии dbt_project.yml относятся к совместимости проекта dbt с определенной версией dbt. Номера версий в файлах свойств .yml указывают, как dbt интерпретирует эти YAML файлы. Последние два являются полностью необязательными, начиная с dbt версии 1.5.

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

Версии в dbt_project.yml

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

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

Для получения дополнительной информации о версиях Core, см. О версиях dbt Core.

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

ЧАВО

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

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

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