# Миграция 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](https://docs.getdbt.tech/docs/platform/dbt-cli-installation.md).

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

```bash
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 необходимо повторно уточнить после обновления.