Перейти к основному содержимому

Миграция dbt platform CLI

С 14 сентября 2026 года команда pip install dbt будет устанавливать dbt v2 вместо dbt platform CLI. Если вы устанавливаете dbt platform CLI с помощью pip, вам необходимо принять меры, чтобы продолжить пользоваться им без перебоев.

Что изменится​

С 14 сентября 2026 года команда pip install dbt будет устанавливать v2 — движок dbt нового поколения на базе Rust — вместо dbt platform CLI. Это разовое изменение содержимого пакета dbt на PyPI, а не обновление dbt platform CLI.

Если сейчас вы устанавливаете dbt platform CLI с помощью pip и не фиксируете версию, при следующем выполнении pip install dbt или pip install --upgrade dbt вместо него будет установлен v2. dbt v2 — это другой движок: он работает локально через подключение к хранилищу данных, которое вы настраиваете самостоятельно, а не выполняет команды в вашей среде разработки dbt platform. Команды dbt cancel, dbt reattach, dbt environment, dbt sl export и dbt sqlfluff в v2 отсутствуют.

Что нужно сделать​

Если вы используете dbt platform CLI и хотите продолжить им пользоваться, переустановите его актуальным для вашей операционной системы способом — через Homebrew на macOS или с помощью нативного исполняемого файла на Windows или Linux. Подробные инструкции приведены в разделе Установка dbt platform CLI.

Если вы не можете переустановить его прямо сейчас (например, в Docker-образе доступен только pip), зафиксируйте версию:

pip install dbt==1.0.0.40.20

Эта версия продолжит работать без ограничения по времени, но больше не будет получать обновления dbt platform CLI через pip. Для долгосрочного использования следует переустановить инструмент одним из поддерживаемых сейчас способов.

Основные области, которых коснутся изменения​

  • Dockerfile / пайплайны CI: любые шаги с pip install dbt без фиксации версии. Найдите в своих репозиториях команды pip install dbt, в которых версия не зафиксирована с помощью ==.
  • Airflow: задачи BashOperator/KubernetesPodOperator, которые устанавливают CLI в образ рабочего узла на этапе сборки.
  • requirements.txt / Pipfile / pyproject.toml: любые записи dbt без фиксации версии.
  • dbt Power User (расширение VS Code): расширение вызывает dbt platform CLI через командную оболочку. Зафиксируйте версию тем же способом; никаких отдельных действий с самим расширением не требуется.

Часто задаваемые вопросы​

  • Почему dbt Labs вносит это изменение? В дальнейшем dbt v2 станет новым движком dbt по умолчанию. Публикация под именем dbt на PyPI означает, что новые пользователи будут получать v2 по умолчанию — так же, как это уже происходит при установке dbt другими способами (через Homebrew или отдельный установщик).

  • Перестанет ли работать моя зафиксированная версия dbt platform CLI? Нет. Установленные версии с фиксацией продолжат работать. Они просто перестанут получать новые выпуски dbt platform CLI через pip после 14 сентября. Чтобы получать их, переустановите инструмент одним из поддерживаемых сейчас способов.

  • Как определить, какой вариант у меня установлен? Выполните dbt --version. dbt platform CLI выводит версию вида 0.40.20; соответствующая версия на PyPI — 1.0.0.40.20. Формат строки версии dbt v2 необходимо повторно уточнить после обновления.

Нашли ошибку?

0
Loading