О версиях dbt
dbt v2 — это текущее поколение dbt, использующее серию выпусков 2.x. dbt v1 — поколение на основе Python, которое остается в серии 1.x. Оба поколения следуют семантическому версионированию. На этой странице рассматривается версионирование локальных установок dbt.
v2 поставляется в двух дистрибутивах. Установите dbt v2, чтобы получить полный, рекомендуемый набор возможностей. Если в вашей организации действует строгое требование использовать среду выполнения с лицензией Apache 2.0, установите dbt OSS. Дополнительную информацию см. в разделе Лицензирование dbt.
Если вы используете dbt platform (включая dbt platform CLI), вам не нужно самостоятельно управлять версиями dbt. Каналы выпусков автоматически поддерживают актуальность вашей версии и предоставляют ранний доступ к новым возможностям.
Версионирование dbt v2
dbt v2 использует семантическое версионирование начиная с версии 2.0. Чтобы установить или обновить dbt v2, см. раздел Установка dbt.
Последний выпуск
| dbt v2 | Первоначальный выпуск | Уровень поддержки и дата ее окончания |
|---|---|---|
| v2.0 | 14 сентября 2026 г. | Активная поддержка — до 13 сентября 2027 г. |
Семантическое версионирование
dbt v2 следует семантическому версионированию:
- Мажорные версии (например, переход с 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.
Проверка версии
Выполните dbt --version, чтобы проверить установленную версию:
$ dbt --version
dbt v2 2.0.0
Дополнительные материалы
- Установка dbt v2: установите или обновите dbt v2.
- Выпуски dbt v2: ознакомьтесь с текущими версиями и историей выпусков.
- Начало работы с dbt v2: узнайте о возможностях dbt v2 и переходе на этот движок.
Версионирование dbt v1
Движок dbt v1 использует семантическое версионирование для серии выпусков 1.x. Чтобы установить или обновить dbt v1, см. раздел Установка dbt.
- Активная поддержка: В первые несколько месяцев после первоначального выпуска минорной версии мы выпускаем для неё патч-релизы с исправлениями ошибок. Они включают исправления регрессий, новых и ранее обнаруженных ошибок, а также улучшения удобства использования. Мы вносим такие изменения, когда с высокой уверенностью можем утверждать, что они имеют узкую область воздействия и не вызовут непредвиденных побочных эффектов.
- Критическая поддержка: После выхода новой минорной версии предыдущая переходит в режим «Критическая поддержка» на оставшуюся часть годового периода поддержки. В этот период патч-релизы ограничиваются критическими исправлениями безопасности и проблем установки. По истечении годового периода жизненный цикл версии завершается.
- Завершение жизненного цикла: Минорные версии, жизненный цикл которых завершён (EOL), больше не получают новых патч-релизов.
- Устаревшие версии: Версии dbt v1, которые больше не обслуживаются dbt Labs и не поддерживаются в dbt platform.
Последние выпуски
| dbt v1 | Дата первого выпуска | Уровень поддержки и дата её окончания |
|---|---|---|
| v1.13 | (скоро) | Бета-версия |
| v1.12 | 16 июля 2026 г. | Активная поддержка — 15 июля 2027 г. |
| v1.11 | 19 декабря 2025 г. | Поддержка критических исправлений — 18 декабря 2026 г. |
| v1.10 | 16 июня 2025 г. | Выведена из эксплуатации ⛔️ |
| v1.9 | 9 декабря 2024 г. | Выведена из эксплуатации ⛔️ |
| v1.8 | 9 мая 2024 г. | Выведена из эксплуатации ⛔️ |
| v1.7 | 2 ноября 2023 г. | Срок поддержки истёк ⚠️ Дата вывода из эксплуатации: January 31, 2027 |
| v1.6 | 31 июля 2023 г. | Срок поддержки истёк ⚠️ Дата вывода из эксплуатации: January 31, 2027 |
| v1.5 | 27 апреля 2023 г. | Срок поддержки истёк ⚠️ Дата вывода из эксплуатации: January 31, 2027 |
| v1.4 | 25 января 2023 г. | Срок поддержки истёк ⚠️ Дата вывода из эксплуатации: January 31, 2027 |
| v1.3 | 12 октября 2022 г. | Срок поддержки истёк ⚠️ Дата вывода из эксплуатации: January 31, 2027 |
| v1.2 | 26 июля 2022 г. | Выведена из эксплуатации ⛔️ |
| v1.1 | 28 апреля 2022 г. | Выведена из эксплуатации ⛔️ |
| v1.0 | 3 декабря 2021 г. | Выведена из эксплуатации ⛔️ |
| v0.X ⛔️ | (разные даты) | Выведена из эксплуатации ⛔️ |
Все функциональные возможности v1, начиная с выпуска v1.7, доступны в каналах обновлений dbt, которые обеспечивают автоматическое обновление с периодичностью, подходящей вашей команде.
1 Использование каналов обновлений обязательно для тарифных планов Developer и Starter в dbt. Учётные записи, использующие более старые версии dbt, будут переведены на канал обновлений v1 Latest.
Для клиентов dbt: dbt Labs настоятельно рекомендует переводить среды со старых и неподдерживаемых версий на каналы обновлений или поддерживаемую версию. С January 31, 2027 dbt Labs выведет из эксплуатации версии v1 с v1.3 по v1.7, после чего они станут недоступны в dbt platform.
Как dbt v1 использует семантическое версионирование
dbt следует семантическому версионированию:
- Мажорные версии (например, переход с v1 на v2) могут включать изменения, нарушающие обратную совместимость. Устаревшая функциональность перестанет работать.
- Минорные версии (например, переход с v1.8 на v1.9) добавляют новые возможности и сохраняют обратную совместимость. Они не нарушают работу кода проекта, который использует документированную функциональность.
- Патч-версии (например, переход с v1.8.0 на v1.8.1) содержат только исправления: ошибок, уязвимостей безопасности или проблем с установкой.
Мы стремимся не допускать в минорных версиях изменений, нарушающих обратную совместимость для конечных пользователей dbt. В минорные версии могут включаться два типа изменений, нарушающих обратную совместимость:
-
Изменения интерфейса Python для плагинов адаптеров. Эти изменения касаются только разработчиков, сопровождающих адаптеры; о них будет явно сообщаться в документации и примечаниях к выпуску. Дополнительную информацию см. в руководстве по разработке, тестированию, документированию и продвижению адаптеров.
-
Изменения интерфейсов метаданных, включая артефакты и ведение журналов, обозначаемые повышением номера версии. Такие обновления версий могут потребовать обновления внешнего кода, зависящего от этих интерфейсов, или согласования обновлений между процессами оркестрации dbt, которые используют общие метаданные, например при выборе на основе состояния.
Версии плагинов адаптеров
dbt выпускает dbt-core и плагины адаптеров (например, dbt-snowflake) независимо друг от друга. Номера их минорных и патч-версий могут не совпадать, но взаимодействие согласуется через интерфейс dbt-adapters, поэтому это не нарушает их совместную работу. Например, dbt-core==1.8.0 может работать с dbt-snowflake==1.9.0.
Если вы разрабатываете или сопровождаете адаптер, сведения об интерфейсе dbt-adapters см. в руководстве по созданию адаптеров.
Выполните dbt --version, чтобы проверить установленные версии:
$ dbt --version
Core:
- installed: 1.8.0
- latest: 1.8.0 - Up to date!
Plugins:
- snowflake: 1.9.0 - Up to date!
Версию зарегистрированного адаптера также можно найти в журналах. Например, в logs/dbt.log:
[0m13:13:48.572182 [info ] [MainThread]: Registered adapter: snowflake=1.9.0
Полный список адаптеров см. в разделе Поддерживаемые платформы данных.
Дополнительные материалы
- Выбор версии dbt v1 в : узнайте, как использовать версии dbt v1 в dbt.
- Установка dbt v1: установите или обновите dbt v1.
require-dbt-versionиdbt_version: ограничьте работу проекта определенным диапазоном версий.
Версии с завершенным сроком поддержки
С January 31, 2027 версии dbt v1.3–v1.7 будут объявлены устаревшими и станут недоступны в dbt platform. До этой даты обновите все среды, которые еще используют эти версии, до поддерживаемой версии или переведите их на канал выпусков.
Когда версия dbt достигает конца срока поддержки (EOL), для нее больше не выпускаются патчи, в том числе исправления известных ошибок. Рекомендуем перейти на более новую версию в dbt, dbt v2 или dbt v1. Все версии до v1.0 объявлены устаревшими.
Поддержка текущих версий
dbt поддерживает каждую минорную версию (например, v1.8) в течение одного года с момента ее первоначального выпуска. В этот период мы выпускаем патчи с исправлениями ошибок и обновлениями безопасности. Когда мы упоминаем минорную версию, мы подразумеваем ее последнюю доступную патч-версию (v1.8.x).
После выхода новой минорной версии предыдущая переходит в режим поддержки только критических исправлений (исправлений безопасности и проблем с установкой) на оставшуюся часть своего годового срока поддержки. По истечении года версия достигает конца срока поддержки и больше не получает патчи.
Пока минорная версия официально поддерживается:
- Вы можете использовать ее в dbt. Подробнее о версионировании dbt см. в разделе Выбор версии dbt.
- Вы можете выбрать ее в раскрывающемся списке версий на этом сайте, чтобы просмотреть документацию, соответствующую этой минорной версии.
Обновление
Обновляйтесь до новых патч-версий сразу после их появления. Переходите на новые минорные версии, когда будете готовы, поскольку некоторые возможности и исправления доступны только в последней минорной версии.
dbt предоставляет все версии в виде предварительных выпусков до выхода окончательного выпуска. Для минорных версий мы стремимся выпустить одну или несколько бета-версий не менее чем за 4 недели до окончательного выпуска, чтобы вы могли опробовать новые возможности и поделиться отзывами. Релиз-кандидаты становятся доступны примерно за две недели до окончательного выпуска для тестирования в средах, приближенных к рабочим. Подробности см. в планах выпусков dbt-labs/dbt.
