# Установка dbt

Локальная разработка(Версии dbt: v2.0 и новее)

Запустите dbt на своём компьютере за несколько минут. При установке dbt по умолчанию вы получаете dbt v2 — актуальное бесплатное решение для работы с v2. Выберите удобный способ установки:

## Установка dbt

### pip

```shell
python -m pip install dbt
```

Для последующего обновления выполните `python -m pip install --upgrade dbt`.

### Homebrew (macOS)

```shell
brew tap dbt-labs/dbt
brew install dbt-labs/dbt/dbt
```

Для последующего обновления выполните `brew upgrade dbt`.

### curl (macOS/Linux)

```shell
curl -fsSL https://public.cdn.getdbt.com/fs/install/install.sh | sh -s -- --update
```

Эта команда устанавливает исполняемый файл dbt в `~/.local/bin/dbt` и добавляет этот каталог в `$PATH`. Если потребуется удалить его, см. [инструкцию по удалению после установки через curl](#faqs).

Закройте и снова откройте терминал (или выполните `exec $SHELL`), чтобы изменения `$PATH` вступили в силу.

Для последующего обновления выполните `dbt system update`.

### winget (Windows)

```shell
winget install --id dbtLabs.dbt --exact
```

Чтобы установить определённую версию, выполните `winget install --id dbtLabs.dbt --exact --version <version>`.

### Windows (PowerShell)

```powershell
irm https://public.cdn.getdbt.com/fs/install/install.ps1 | iex
```

Закройте и снова откройте командную оболочку (или выполните `Start-Process powershell`), чтобы изменения `Path` вступили в силу.

Для последующего обновления выполните `dbt system update`.

* Проверьте установку:

  ```shell
  dbt --version
  ```

* Вы можете начать работать с dbt v2 сразу после установки. Для максимально удобной работы с v2 в редакторе установите расширение dbt для VS Code: оно предоставляет автодополнение, отображение ошибок прямо в коде и граф зависимостей данных.

  Чтобы получить полный набор возможностей LSP и другие функции на базе платформы dbt, выполните `dbt login` и войдите с помощью бесплатной учётной записи dbt platform:

  ```shell
  dbt login
  ```

Подробнее см. в [документации расширения dbt для VS Code](https://docs.getdbt.tech/docs/about-dbt-extension.md).

Если вам или вашей организации строго необходимо использовать среду выполнения с открытым исходным кодом, см. [Установка dbt OSS](https://docs.getdbt.tech/docs/local/install-dbt-v2.md). Обратите внимание: `dbt-oss` и `dbt` нельзя устанавливать в одну среду Python.

## Устранение неполадок

Распространённые проблемы и способы их решения:

* **Команда dbt не найдена:** добавьте каталог установки в `$PATH`.
* **Конфликты версий:** убедитесь, что на вашем компьютере не установлены и не активны другие версии локально развёрнутого dbt или dbt platform CLI.
* **Конфликт с `dbt-oss`:** `dbt-oss` и `dbt` нельзя устанавливать в одну среду Python. Если вам нужны оба инструмента, создайте псевдоним, как описано в разделе [Запуск dbt-oss параллельно с другими установками dbt](https://docs.getdbt.tech/docs/local/install-dbt-v2.md#run-dbt-oss-alongside-other-dbt-installs).
* **Разрешения на установку:** убедитесь, что у вашей учётной записи есть права на локальную установку программного обеспечения.

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

*  Можно ли вернуться к предыдущей установке dbt?

  Да. Чтобы протестировать новую установку, не затрагивая существующие рабочие процессы, используйте отдельную среду или виртуальную машину.

*  Можно ли скачать только среду выполнения с лицензией Apache 2.0?

  Да, если вам нужна среда выполнения с лицензией Apache 2.0, вы можете [установить dbt v2 с открытым исходным кодом](https://docs.getdbt.tech/docs/local/install-dbt-v2.md) — проект с открытым исходным кодом, лежащий в основе dbt v2.

*  Как удалить dbt после установки через curl (install.sh)?

  Эти действия применимы только в том случае, если вы установили dbt v2 с помощью скрипта curl (`install.sh`). Если вы использовали pip, Homebrew или winget, удалите dbt с помощью соответствующего инструмента (например, `pip uninstall dbt` или `brew uninstall dbt`).

  1. **Удалите dbt.** Выполните встроенную команду удаления, чтобы очистить кешированные файлы и сохранённое состояние. Она также удалит исполняемый файл:

     ```shell
     dbt system uninstall
     ```

  2. **Очистите профиль командной оболочки.** Установщик добавляет команду экспорта `$PATH` и псевдоним `dbtf` в `~/.zshrc` или `~/.bashrc`, каждый под отдельным комментарием. Откройте этот файл и удалите следующие строки:

     ```shell
     # Added by dbt installer
     export PATH="$PATH:$HOME/.local/bin"

     # dbt aliases
     alias dbtf=$HOME/.local/bin/dbt
     ```

     Затем перезагрузите профиль:

     ```shell
     source ~/.zshrc   # or source ~/.bashrc
     ```

## Дополнительная информация о dbt v2

* [Журнал изменений dbt v2](https://github.com/dbt-labs/dbt/blob/main/CHANGELOG-dbt.md)
* [О расширении dbt](https://docs.getdbt.tech/docs/about-dbt-extension.md)
* [Краткое руководство по началу работы с dbt v2](https://docs.getdbt.tech/guides/dbt.md?step=1)
* [Руководство по обновлению](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v2.md)
* [Лицензионное соглашение dbt v2](https://www.getdbt.com/dbt-fusion-engine-license-agreement)

## Следующие шаги

* Настройте [переменные среды](https://docs.getdbt.tech/docs/local/configure-environment-variables.md) для управления учётными данными.
* Настройте файл [profiles.yml](https://docs.getdbt.tech/docs/local/profiles.yml.md#location-of-profilesyml).
* Настройте [подключение к платформе данных](https://docs.getdbt.tech/docs/local/connect-data-platform/about-dbt-connections.md).
* Создайте свой первый [проект dbt](https://docs.getdbt.tech/docs/build/projects.md) с помощью команды [`dbt init`](https://docs.getdbt.tech/reference/commands/init.md).