О версиях dbt Core
Релизы dbt Core следуют рекомендациям семантического версионирования. Подробнее о том, как мы используем семантические версии, см. раздел How dbt Core uses semantic versioning.
Знали ли вы, что всегда можете работать с последними функциями и возможностями?
С помощью dbt вы можете получить ранний доступ к новой функциональности до того, как она станет доступна в dbt Core, и при этом вам не нужно самостоятельно управлять обновлениями версий. Подробности смотрите в настройке трека релизов "Latest".
dbt Labs предоставляет различные уровни поддержки для разных версий, которые могут включать новые функции, исправления ошибок или патчи безопасности:
- Active — Мы выпускаем патчи для регрессий и новых багов, а также включаем исправления старых ошибок и улучшения удобства использования. Мы вносим такие изменения, когда у нас есть высокая уверенность, что они имеют узкую область воздействия и не приведут к непредвиденным побочным эффектам.
- Critical — Более новые минорные версии переводят предыдущую минорную версию в режим «Critical Support» с ограниченными «security»-релизами для критических исправлений безопасности и проблем установки.
- End of Life — Минорные версии, достигшие статуса EOL, больше не получают новые патч-релизы.
- Deprecated — Версии dbt Core, которые больше не поддерживаются dbt Labs и не поддерживаются в dbt platform.
Последние выпуски
| Loading table... |
Вся функциональность dbt Core, начиная с релиза v1.7, доступна в release tracks для [dbt], которые обеспечивают автоматические обновления с периодичностью, подходящей для вашей команды.
1 Release tracks являются обязательными для тарифных планов Developer и Starter в dbt. Аккаунты, использующие более старые версии dbt, будут автоматически переведены на release track «Latest».
Для клиентов dbt: dbt Labs настоятельно рекомендует перенести окружения, использующие старые и неподдерживаемые версии, на release tracks или на поддерживаемую версию. В 2025 году dbt Labs удалит самые старые версии dbt Core из доступных в dbt platform, начиная с версий v1.0–v1.2.
Дополнительное чтение
- Чтобы узнать, как можно использовать версии dbt Core в dbt, см. Choosing a dbt Core version.
- Чтобы узнать об установке dbt Core, см. “How to install dbt Core”.
- Чтобы ограничить проект работой только с определённым диапазоном версий dbt Core или использовать текущую запущенную версию dbt Core, см.
require-dbt-versionиdbt_version.
Поддержка версий до v1.0
Все версии dbt Core, выпущенные до 1.0, а также соответствующая им документация по версиям, были объявлены устаревшими. При обновлении до одной из текущих поддерживаемых версий ознакомьтесь с нашими лучшими практиками обновления.
Поддержка версий, достигших конца срока службы (EOL)
Все минорные версии dbt Core, которые достигли конца жизненного цикла (end-of-life, EOL), больше не будут получать новые патч-релизы. Это означает, что для них больше не будут выпускаться какие-либо исправления, в том числе для уже известных и выявленных ошибок. Исправления таких ошибок будут выпускаться только в более новых минорных версиях, которые всё ещё находятся на активной поддержке.
Мы рекомендуем обновиться до более новой версии в dbt или dbt Core, чтобы продолжать получать поддержку.
Все версии dbt Core начиная с v1.0 доступны в dbt до дальнейшего уведомления. В будущем мы планируем синхронизировать доступность dbt с периодами активной поддержки dbt Core. О любых изменениях вы будете уведомлены заранее и заблаговременно.
Текущая поддержка версий
Минорные версии
Минорные версии включают новые функции и возможности. Они будут поддерживаться в течение одного года с даты их первоначального выпуска. dbt Labs обязуется соблюдать этот 12-месячный срок поддержки. Наш механизм продолжения поддержки минорной версии заключается в выпуске новых патчей: небольших, целевых исправлений ошибок. Всякий раз, когда мы ссылаемся на минорную версию, такую как v1.0, мы всегда имеем в виду ее последний доступный патч-релиз (v1.0.x).
Пока минорная версия официально поддерживается:
- Вы можете использовать ее в dbt Cloud. Подробнее о версионировании dbt Cloud см. в разделе Выбор версии dbt.
- Вы можете выбрать ее из выпадающего списка версий на этом сайте, чтобы увидеть документацию, которая точна для использования с этой минорной версией.
Пока минорная версия официально поддерживается:
- Вы можете использовать её в dbt. Подробнее о версионировании dbt см. Choosing a dbt version.
- Вы можете выбрать её в выпадающем списке версий на этом сайте, чтобы просматривать документацию, которая соответствует использованию именно этой минорной версии.
В течение 12-месячного окна поддержки мы будем продолжать выпускать новые патч-версии, которые включают исправления.
Активная поддержка: В первые несколько месяцев после первоначального выпуска минорной версии мы будем выпускать патчи с исправлениями ошибок. Они будут включать исправления для регрессий и новых ошибок, которые присутствовали в оригинальном выпуске минорной версии.
Критическая поддержка: Когда доступна новая минорная версия, мы переведем предыдущую минорную версию в "Критическую поддержку". Последующие патчи для этой старой минорной версии будут только "безопасными" релизами, ограниченными критическими исправлениями, связанными с безопасностью и установкой.
После того, как минорная версия достигнет конца своего критического периода поддержки, через год после ее первоначального выпуска, новые патчи выпускаться не будут.
Будущие версии
Для получения последней информации о предстоящих релизах, включая запланированные даты выпуска и какие функции и исправления могут быть включены, обратитесь к этапам репозитория dbt-core и дорожным картам продукта.
Лучшие практики обновления
Из-за нашей новой практики версионирования мы изложили лучшие практики и ожидания для пользователей dbt по обновлению, поскольку мы продолжаем выпускать новые версии dbt Core.
В связи с нашей новой практикой версионирования мы сформулировали лучшие практики и ожидания для пользователей dbt при обновлении, по мере того как мы продолжаем выпускать новые версии dbt Core.
Мы ожидаем, что пользователи будут обновляться до патчей, как только они станут доступны. Когда мы говорим о "минорной версии" dbt Core, такой как v1.0, мы всегда имеем в виду последний доступный патч-релиз для этой минорной версии. Мы рекомендуем вам структурировать ваши среды разработки и производства так, чтобы вы всегда могли устанавливать последние патчи dbt-core и любых адаптеров. (Обратите внимание, что номера патчей могут отличаться между dbt-core и плагинами. См. ниже для объяснения.)
Обновление до новых минорных версий
В течение официального периода поддержки минорные версии будут оставаться доступными в dbt Cloud и в выпадающем списке версий на сайте документации. Хотя мы не ожидаем, что пользователи немедленно обновятся до новых минорных версий, как только они станут доступны, всегда будут некоторые функции и исправления, доступные только для пользователей последней минорной версии.
В течение официального периода поддержки минорные версии будут оставаться доступными в dbt и в выпадающем списке версий на сайте документации. Хотя мы не ожидаем, что пользователи будут сразу обновляться до новых минорных версий, как только они станут доступны, некоторые функции и исправления всегда будут доступны только пользователям самой последней минорной версии.
Все версии dbt Core доступны как предварительные релизы до окончательного выпуска. "Кандидаты на релиз" доступны для тестирования в средах, похожих на производственные, за две недели до окончательного выпуска. Для минорных версий мы также стремимся выпустить один или несколько "бета-релизов", которые включают новые функции и приглашают к обратной связи от сообщества, за 4+ недели до окончательного выпуска. Вам выгодно помочь нам тестировать предварительные релизы — нам нужна ваша помощь!
Все версии dbt Core доступны в виде пререлизов до финального релиза. «Кандидаты на релиз» (release candidates) становятся доступны для тестирования в окружениях, близких к продакшену, за две недели до финального релиза. Для минорных версий мы также стараемся выпускать одну или несколько «бета»-версий, которые включают новые возможности и предполагают получение обратной связи от сообщества, за 4 и более недель до финального релиза. В ваших интересах помогать нам с тестированием пререлизов — нам действительно нужна ваша помощь!
Как и многие программные проекты, релизы dbt Core следуют семантическому версионированию, которое определяет три типа выпусков версий.
Как и многие программные проекты, релизы dbt Core следуют принципам семантического версионирования, которое определяет три типа выпусков версий.
-
Мажорные версии (Major): На сегодняшний день у dbt Core был один мажорный релиз — v1.0.0. Когда будет выпущена версия v2.0.0, она принесёт новые возможности, а функциональность, ранее объявленная устаревшей (deprecated), перестанет работать.
-
Минорные версии (Minor), также называемые «фиче-релизами», включают сочетание новых возможностей, внутренних улучшений и изменений существующего функционала, которые являются обратно совместимыми с предыдущими минорными версиями. Такие релизы не ломают код в вашем проекте, который опирается на задокументированную функциональность.
-
Патч-версии (Patch), также называемые «bugfix» или «security» релизами, содержат только исправления. Эти исправления могут быть необходимы для восстановления предыдущего (задокументированного) поведения, устранения очевидных недостатков новых возможностей или для критических исправлений, связанных с безопасностью или установкой. Мы тщательно подходим к выбору исправлений, включаемых в патч-релизы, чтобы минимизировать объём изменений.
-
Изменения в интерфейсе Python для адаптеров. Эти изменения актуальны только для разработчиков адаптеров, и они будут четко указаны в документации и примечаниях к релизу. Для получения дополнительной информации обратитесь к руководству Создание, тестирование, документирование и продвижение адаптеров.
-
Изменения в интерфейсах метаданных, включая артефакты и логирование, сигнализируемые повышением версии. Эти обновления версий могут потребовать от вас обновления внешнего кода, который зависит от этих интерфейсов, или координации обновлений между оркестрациями dbt, которые обмениваются метаданными, такими как выбор на основе состояния.
Как мы версионируем адаптеры
Когда вы используете dbt, вы используете комбинацию dbt-core и плагина адаптера, специфичного для вашей базы данных. Вы можете увидеть текущий список в Поддерживаемые платформы данных. И dbt-core, и плагины адаптеров dbt следуют семантическому версионированию.
dbt-core и плагины адаптеров используют интерфейс dbt-adapters для координации новых функций и изменений за кулисами. Новые функции адаптеров определяются в dbt-adapters (которые будет использовать dbt-core). Эти функции являются опциональными, что означает, что они влияют только на адаптеры, которые их явно реализуют. Это позволяет нам независимо выпускать адаптеры, dbt-adapters и dbt-core, не создавая проблем для пользователей.
В отличие от версий dbt-core до 1.8, номера минорных и патч-версий могут не совпадать между dbt-core и установленными вами плагинами адаптеров.
Например, вы можете обнаружить, что используете dbt-core==1.8.0 с dbt-snowflake==1.9.0. Хотя у них разные минорные версии, они все равно могут работать вместе, так как оба работают с dbt-adapters==1.8.0. Патч-релизы могут содержать важные исправления ошибок или безопасности, поэтому критически важно оставаться в курсе.
Вы можете использовать команду 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
Вероятно, с тех пор стали доступны новые патчи, поэтому всегда важно проверять и убеждаться, что вы в курсе!
