# version

Версии моделей, версии dbt\_project.yml и версии .yml

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

* [Model versions](https://docs.getdbt.tech/docs/mesh/govern/model-versions.md) — функция dbt Mesh, которая обеспечивает более эффективное управление и контроль моделей данных, позволяя отслеживать изменения и обновления моделей с течением времени.
* [dbt\_project.yml version](https://docs.getdbt.tech/reference/project-configs/version.md#dbt_projectyml-versions) (опционально) — версия `dbt_project.yml` не связана с Mesh и указывает на совместимость dbt-проекта с конкретной версией dbt.
* [.yml property file version](https://docs.getdbt.tech/reference/project-configs/version.md#yml-property-file-versions) (опционально) — номера версий в .yml-файлах свойств определяют, как dbt интерпретирует эти YAML-файлы. Не связано с Mesh.

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

## Версии в `dbt_project.yml`

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

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

Начиная с версии dbt 1.5, параметр `version` в файле `dbt_project.yml` является *необязательным*. Если он используется, значение версии должно быть указано в формате [семантического версионирования](https://semver.org/), например `1.0.0`. Если параметр не задан, по умолчанию используется значение `None`. Для пользователей dbt версии 1.4 и ниже этот параметр является обязательным, хотя в настоящее время dbt не использует его каким-либо значимым образом.

Подробнее о версиях dbt v1 см. в разделе [О версиях dbt](https://docs.getdbt.tech/docs/dbt-versions.md).

dbt\_project.yml

```yml
version: version
```

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

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

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

Подробнее о файлах свойств см. их общую [документацию](https://docs.getdbt.tech/reference/define-properties.md) на этой же странице.

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

\<any valid filename>.yml

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

models: 
    ...
```

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

\<any valid filename>.yml

```yml

models: 
    ...
```

## ЧАВО

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

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

Начиная с [dbt v1.5](<https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/Older versions/upgrading-to-v1.5/.md#quick-hits>), ключ `version:` верхнего уровня необязателен во всех YAML-файлах ресурсов. Если он указан, поддерживается только значение `version: 2`.

Также, начиная с версии 1.5, и [`config-version: 2`](https://docs.getdbt.tech/reference/project-configs/config-version.md), и ключ верхнего уровня `version:` в файле `dbt_project.yml` являются необязательными.

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