# О версиях dbt

dbt v2 — это текущее поколение dbt, использующее серию выпусков 2.x. dbt v1 — поколение на основе Python, которое остается в серии 1.x. Оба поколения следуют семантическому версионированию. На этой странице рассматривается версионирование локальных установок dbt.

v2 поставляется в двух дистрибутивах. Установите dbt v2, чтобы получить полный, рекомендуемый набор возможностей. Если в вашей организации действует строгое требование использовать среду выполнения с лицензией Apache 2.0, установите dbt OSS. Дополнительную информацию см. в разделе [Лицензирование dbt](https://docs.getdbt.tech/docs/dbt-licensing.md).

Если вы используете dbt platform (включая dbt platform CLI), вам не нужно самостоятельно управлять версиями dbt. [Каналы выпусков](https://docs.getdbt.tech/docs/dbt-versions/dbt-release-tracks.md) автоматически поддерживают актуальность вашей версии и предоставляют ранний доступ к новым возможностям.

## Версионирование dbt v2

dbt v2 использует семантическое версионирование начиная с версии 2.0. Чтобы установить или обновить dbt v2, см. раздел [Установка dbt](https://docs.getdbt.tech/docs/local/install-dbt.md?version=2).

### Последний выпуск

| dbt v2                                                                                 | Первоначальный выпуск | Уровень поддержки и дата ее окончания           |
| -------------------------------------------------------------------------------------- | --------------------- | ----------------------------------------------- |
| [**v2.0**](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v2.md) | 14 сентября 2026 г.   | **Активная поддержка — до 13 сентября 2027 г.** |

### Семантическое версионирование

dbt v2 следует [семантическому версионированию](https://semver.org/):

* **Мажорные версии** (например, переход с v2 на v3) могут включать изменения, нарушающие обратную совместимость. Устаревшая функциональность перестанет работать.
* **Минорные версии** (например, переход с v2.0 на v2.1) добавляют новые возможности и сохраняют обратную совместимость. Они не нарушают работу кода проекта, который использует документированную функциональность.
* **Патч-версии** (например, переход с v2.0.0 на v2.0.1) содержат только исправления: ошибок, уязвимостей безопасности или проблем с установкой.

### Каналы распространения

dbt v2 распространяется через следующие каналы:

| Канал    | Описание                               | Стабильность                                                                   |
| -------- | -------------------------------------- | ------------------------------------------------------------------------------ |
| `latest` | Стабильная, проверенная версия         | ✅ Рекомендуется большинству пользователей                                     |
| `canary` | Последняя официально выпущенная версия | ⚠️ Самая новая стабильная версия, которая еще проходит тщательное тестирование |
| `dev`    | Последняя сборка в процессе разработки | ❌ Может не пройти все тесты                                                   |

Выполните `dbt system update`, чтобы получить последний стабильный выпуск, или укажите канал с помощью `dbt system update --version canary`.

Текущие версии и историю выпусков см. в разделе [Выпуски dbt v2](https://docs.getdbt.tech/docs/dbt/dbt-releases.md).

### Проверка версии

Выполните `dbt --version`, чтобы проверить установленную версию:

```text
$ dbt --version
dbt v2 2.0.0
```

### Дополнительные материалы

* [Установка dbt v2](https://docs.getdbt.tech/docs/local/install-dbt.md?version=2): установите или обновите dbt v2.
* [Выпуски dbt v2](https://docs.getdbt.tech/docs/dbt/dbt-releases.md): ознакомьтесь с текущими версиями и историей выпусков.
* [Начало работы с dbt v2](https://docs.getdbt.tech/docs/dbt/get-started-dbt.md): узнайте о возможностях dbt v2 и переходе на этот движок.

## Версионирование dbt v1

Движок dbt v1 использует семантическое версионирование для серии выпусков 1.x. Чтобы установить или обновить dbt v1, см. раздел [Установка dbt](https://docs.getdbt.tech/docs/local/install-dbt.md?version=1).

* **[Активная поддержка](https://docs.getdbt.tech/docs/dbt-versions.md#current-version-support)**: В первые несколько месяцев после первоначального выпуска минорной версии мы выпускаем для неё патч-релизы с исправлениями ошибок. Они включают исправления регрессий, новых и ранее обнаруженных ошибок, а также улучшения удобства использования. Мы вносим такие изменения, когда с высокой уверенностью можем утверждать, что они имеют узкую область воздействия и не вызовут непредвиденных побочных эффектов.
* **[Критическая поддержка](https://docs.getdbt.tech/docs/dbt-versions.md#current-version-support)**: После выхода новой минорной версии предыдущая переходит в режим «Критическая поддержка» на оставшуюся часть годового периода поддержки. В этот период патч-релизы ограничиваются критическими исправлениями безопасности и проблем установки. По истечении годового периода жизненный цикл версии завершается.
* **[Завершение жизненного цикла](https://docs.getdbt.tech/docs/dbt-versions.md#end-of-life-versions)**: Минорные версии, жизненный цикл которых завершён (EOL), больше не получают новых патч-релизов.
* **Устаревшие версии**: Версии dbt v1, которые больше не обслуживаются dbt Labs и не поддерживаются в dbt platform.

### Последние выпуски

| dbt v1                                                                                                    | Дата первого выпуска | Уровень поддержки и дата её окончания                                      |
| --------------------------------------------------------------------------------------------------------- | -------------------- | -------------------------------------------------------------------------- |
| [**v1.13**](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v1.13.md)                | (скоро)              | Бета-версия                                                                |
| [**v1.12**](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v1.12.md)                | 16 июля 2026 г.      | **Активная поддержка — 15 июля 2027 г.**                                   |
| [**v1.11**](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v1.11.md)                | 19 декабря 2025 г.   | **Поддержка критических исправлений — 18 декабря 2026 г.**                 |
| [**v1.10**](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v1.10.md)                | 16 июня 2025 г.      | Выведена из эксплуатации ⛔️                                               |
| [**v1.9**](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v1.9.md)                  | 9 декабря 2024 г.    | Выведена из эксплуатации ⛔️                                               |
| [**v1.8**](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v1.8.md)                  | 9 мая 2024 г.        | Выведена из эксплуатации ⛔️                                               |
| [**v1.7**](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v1.7.md)                  | 2 ноября 2023 г.     | Срок поддержки истёк ⚠️<br />Дата вывода из эксплуатации: January 31, 2027 |
| [**v1.6**](<https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/Older versions/upgrading-to-v1.6/.md>) | 31 июля 2023 г.      | Срок поддержки истёк ⚠️<br />Дата вывода из эксплуатации: January 31, 2027 |
| [**v1.5**](<https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/Older versions/upgrading-to-v1.5/.md>) | 27 апреля 2023 г.    | Срок поддержки истёк ⚠️<br />Дата вывода из эксплуатации: January 31, 2027 |
| [**v1.4**](<https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/Older versions/upgrading-to-v1.4/.md>) | 25 января 2023 г.    | Срок поддержки истёк ⚠️<br />Дата вывода из эксплуатации: January 31, 2027 |
| [**v1.3**](<https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/Older versions/upgrading-to-v1.3/.md>) | 12 октября 2022 г.   | Срок поддержки истёк ⚠️<br />Дата вывода из эксплуатации: January 31, 2027 |
| [**v1.2**](<https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/Older versions/upgrading-to-v1.2/.md>) | 26 июля 2022 г.      | Выведена из эксплуатации ⛔️                                               |
| [**v1.1**](<https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/Older versions/upgrading-to-v1.1/.md>) | 28 апреля 2022 г.    | Выведена из эксплуатации ⛔️                                               |
| [**v1.0**](<https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/Older versions/upgrading-to-v1.0/.md>) | 3 декабря 2021 г.    | Выведена из эксплуатации ⛔️                                               |
| **v0.X** ⛔️                                                                                              | (разные даты)        | Выведена из эксплуатации ⛔️                                               |

Все функциональные возможности v1, начиная с выпуска v1.7, доступны в [каналах обновлений dbt](https://docs.getdbt.tech/docs/dbt-versions/dbt-release-tracks.md), которые обеспечивают автоматическое обновление с периодичностью, подходящей вашей команде.

1 Использование каналов обновлений обязательно для тарифных планов Developer и Starter в dbt. Учётные записи, использующие более старые версии dbt, будут переведены на канал обновлений **v1 Latest**.

Для клиентов dbt: dbt Labs настоятельно рекомендует переводить среды со старых и неподдерживаемых версий на [каналы обновлений](https://docs.getdbt.tech/docs/dbt-versions/dbt-release-tracks.md) или поддерживаемую версию. С January 31, 2027 dbt Labs выведет из эксплуатации версии v1 с v1.3 по v1.7, после чего они станут недоступны в dbt platform.

### Как dbt v1 использует семантическое версионирование

dbt следует [семантическому версионированию](https://semver.org/):

* **Мажорные версии** (например, переход с v1 на v2) могут включать изменения, нарушающие обратную совместимость. Устаревшая функциональность перестанет работать.
* **Минорные версии** (например, переход с v1.8 на v1.9) добавляют новые возможности и сохраняют обратную совместимость. Они не нарушают работу кода проекта, который использует документированную функциональность.
* **Патч-версии** (например, переход с v1.8.0 на v1.8.1) содержат только исправления: ошибок, уязвимостей безопасности или проблем с установкой.

Мы стремимся не допускать в минорных версиях изменений, нарушающих обратную совместимость для конечных пользователей dbt. В минорные версии могут включаться два типа изменений, нарушающих обратную совместимость:

* Изменения интерфейса Python для плагинов адаптеров. Эти изменения касаются только разработчиков, сопровождающих адаптеры; о них будет явно сообщаться в документации и примечаниях к выпуску. Дополнительную информацию см. в [руководстве по разработке, тестированию, документированию и продвижению адаптеров](https://docs.getdbt.tech/guides/adapter-creation.md).

* Изменения интерфейсов метаданных, включая [артефакты](https://docs.getdbt.tech/docs/deploy/artifacts.md) и [ведение журналов](https://docs.getdbt.tech/reference/events-logging.md), обозначаемые повышением номера версии. Такие обновления версий могут потребовать обновления внешнего кода, зависящего от этих интерфейсов, или согласования обновлений между процессами оркестрации dbt, которые используют общие метаданные, например при [выборе на основе состояния](https://docs.getdbt.tech/reference/node-selection/syntax.md#about-node-selection).

### Версии плагинов адаптеров

dbt выпускает `dbt-core` и плагины адаптеров (например, `dbt-snowflake`) независимо друг от друга. Номера их минорных и патч-версий могут не совпадать, но взаимодействие согласуется через интерфейс `dbt-adapters`, поэтому это не нарушает их совместную работу. Например, `dbt-core==1.8.0` может работать с `dbt-snowflake==1.9.0`.

Если вы разрабатываете или сопровождаете адаптер, сведения об интерфейсе `dbt-adapters` см. в [руководстве по созданию адаптеров](https://docs.getdbt.tech/guides/adapter-creation.md).

Выполните `dbt --version`, чтобы проверить установленные версии:

```text
$ dbt --version
Core:
  - installed: 1.8.0
  - latest:    1.8.0 - Up to date!

Plugins:
  - snowflake: 1.9.0 - Up to date!
```

Версию зарегистрированного адаптера также можно найти в [журналах](https://docs.getdbt.tech/reference/global-configs/logs.md). Например, в `logs/dbt.log`:

```text
[0m13:13:48.572182 [info ] [MainThread]: Registered adapter: snowflake=1.9.0
```

Полный список адаптеров см. в разделе [Поддерживаемые платформы данных](https://docs.getdbt.tech/docs/supported-data-platforms.md).

### Дополнительные материалы

* [Выбор версии dbt v1 в ](https://docs.getdbt.tech/docs/dbt-versions/upgrade-dbt-platform-version.md): узнайте, как использовать версии dbt v1 в dbt.
* [Установка dbt v1](https://docs.getdbt.tech/docs/local/install-dbt.md?version=1): установите или обновите dbt v1.
* [`require-dbt-version`](https://docs.getdbt.tech/reference/project-configs/require-dbt-version.md) и [`dbt_version`](https://docs.getdbt.tech/reference/dbt-jinja-functions/dbt_version.md): ограничьте работу проекта определенным диапазоном версий.

## Версии с завершенным сроком поддержки

к сведению

С January 31, 2027 версии dbt v1.3–v1.7 будут объявлены устаревшими и станут недоступны в dbt platform. До этой даты обновите все среды, которые еще используют эти версии, до поддерживаемой версии или переведите их на [канал выпусков](https://docs.getdbt.tech/docs/dbt-versions/dbt-release-tracks.md).

Когда версия dbt достигает конца срока поддержки (EOL), для нее больше не выпускаются патчи, в том числе исправления известных ошибок. Рекомендуем перейти на более новую версию в [dbt](https://docs.getdbt.tech/docs/dbt-versions/upgrade-dbt-platform-version.md), [dbt v2](https://docs.getdbt.tech/docs/local/install-dbt.md?version=2) или [dbt v1](https://docs.getdbt.tech/docs/local/install-dbt.md). Все версии до v1.0 объявлены устаревшими.

## Поддержка текущих версий

dbt поддерживает каждую минорную версию (например, v1.8) в течение *одного года* с момента ее первоначального выпуска. В этот период мы выпускаем патчи с исправлениями ошибок и обновлениями безопасности. Когда мы упоминаем минорную версию, мы подразумеваем ее последнюю доступную патч-версию (v1.8.x).

После выхода новой минорной версии предыдущая переходит в режим **поддержки только критических исправлений** (исправлений безопасности и проблем с установкой) на оставшуюся часть своего годового срока поддержки. По истечении года версия достигает **конца срока поддержки** и больше не получает патчи.

Пока минорная версия официально поддерживается:

* Вы можете использовать ее в dbt. Подробнее о версионировании dbt см. в разделе [Выбор версии dbt](https://docs.getdbt.tech/docs/dbt-versions/upgrade-dbt-platform-version.md).
* Вы можете выбрать ее в раскрывающемся списке версий на этом сайте, чтобы просмотреть документацию, соответствующую этой минорной версии.

## Обновление

Обновляйтесь до новых патч-версий сразу после их появления. Переходите на новые минорные версии, когда будете готовы, поскольку некоторые возможности и исправления доступны только в последней минорной версии.

dbt предоставляет все версии в виде предварительных выпусков до выхода окончательного выпуска. Для минорных версий мы стремимся выпустить одну или несколько бета-версий не менее чем за 4 недели до окончательного выпуска, чтобы вы могли опробовать новые возможности и поделиться отзывами. Релиз-кандидаты становятся доступны примерно за две недели до окончательного выпуска для тестирования в средах, приближенных к рабочим. Подробности см. в [планах выпусков `dbt-labs/dbt`](https://github.com/dbt-labs/dbt/milestones).