# Установка dbt v2 в своём окружении

Важно

dbt v2 доступен для установки в следующих средах:

* [Локальные инструменты командной строки (CLI)](https://docs.getdbt.tech/docs/local/install-dbt.md?version=2)
* [VS Code и Cursor с расширением dbt](https://docs.getdbt.tech/docs/install-dbt-extension.md)
* [Среды dbt platform](https://docs.getdbt.tech/docs/dbt-versions/upgrade-dbt-platform-version.md#dbt-v2)

Присоединяйтесь к обсуждению в канале [`#dbt-v2`](https://getdbt.slack.com/archives/C088YCAB6GH) в Slack сообщества dbt.

Узнайте больше о локальной установке dbt v2, включая важные предварительные требования, пошаговые инструкции по установке, устранение распространённых проблем и рекомендации по настройке.

## Предварительные требования

Перед установкой dbt v2 убедитесь, что вы:

* Имеете права администратора для установки программного обеспечения на локальный компьютер.

* Умеете пользоваться интерфейсом командной строки (Terminal в macOS/Linux, PowerShell в Windows).

* Используете поддерживаемое хранилище данных и метод аутентификации, а также настроили необходимые разрешения:

   BigQuery

  * Сервисный аккаунт / Токен пользователя
  * Встроенный OAuth
  * Внешний OAuth
    * [Федерация удостоверений рабочих нагрузок](https://docs.getdbt.tech/docs/platform/manage-access/set-up-bigquery-oauth.md#set-up-bigquery-workload-identity-federation) (Microsoft Entra)
  * [Необходимые разрешения](https://docs.getdbt.tech/docs/platform/connect-data-platform/connect-bigquery.md#required-permissions)

   Databricks

  * Сервисный аккаунт / Токен пользователя
  * Встроенный OAuth

   Redshift

  * Имя пользователя / Пароль
  * Профиль IAM

   Snowflake

  * Имя пользователя / Пароль
  * Встроенный OAuth
  * Внешний OAuth
  * Пара ключей с использованием современного формата PKCS#8
  * MFA

   ClickHouse[Закрытая бета-версия](https://docs.getdbt.tech/docs/dbt-versions/product-lifecycles "Подробнее о статусе или тарифе")

  * Имя пользователя / Пароль

   Apache Spark (только CLI)[Бета-версия](https://docs.getdbt.tech/docs/dbt-versions/product-lifecycles "Подробнее о статусе или тарифе")

  * Thrift

    * Простой уровень аутентификации и безопасности (SASL), механизм PLAIN
    * Без SASL (NOSASL)

  * Livy

    * Базовая аутентификация (имя пользователя и пароль)
    * При развертывании в Amazon Web Services (AWS): AWS Signature Version 4
      * Поддерживается аутентификация с использованием единого входа, сервисных учетных записей или пользовательских токенов

   DuckDB (только CLI)

  DuckDB не требует аутентификации — он работает локально на вашем компьютере.

  *Обратите внимание, что жизненный цикл адаптера может различаться для dbt platform и локальной разработки. Адаптер может стать общедоступным (GA) в платформе dbt раньше, чем для локального использования.*

* Используете поддерживаемую операционную систему:

  * **macOS:** Поддерживаются Intel (x86-64) и Apple Silicon (ARM)
  * **Linux:** Поддерживаются x86-64 и ARM
  * **Windows:** Поддерживается x86-64; поддержка ARM появится в ближайшее время

## Начало работы

Чтобы начать, выберите один из вариантов ниже. Сравнение возможностей см. на странице [Доступность dbt v2](https://docs.getdbt.tech/docs/dbt/dbt-availability.md).

[![](/img/icons/dbt-bit.svg)](https://docs.getdbt.tech/docs/local/install-dbt.md?version=2)

#### [Расширение dbt для VS Code](https://docs.getdbt.tech/docs/local/install-dbt.md?version=2)

[Узнайте, как подключиться к платформе данных, интегрироваться с безопасными методами аутентификации и настроить синхронизацию с git-репозиторием.](https://docs.getdbt.tech/docs/local/install-dbt.md?version=2)

[![](/img/icons/dbt-bit.svg)](https://docs.getdbt.tech/docs/local/install-dbt.md?version=2)

#### [dbt v2 в командной строке](https://docs.getdbt.tech/docs/local/install-dbt.md?version=2)

[Как установить dbt v2 для работы из командной строки (CLI).](https://docs.getdbt.tech/docs/local/install-dbt.md?version=2)

[![](/img/icons/dbt-bit.svg)](https://docs.getdbt.tech/docs/dbt-versions/upgrade-dbt-platform-version.md#dbt-v2)

#### [Обновление до dbt v2](https://docs.getdbt.tech/docs/dbt-versions/upgrade-dbt-platform-version.md#dbt-v2)

[Как обновиться и воспользоваться производительностью и масштабируемостью dbt v2.](https://docs.getdbt.tech/docs/dbt-versions/upgrade-dbt-platform-version.md#dbt-v2)