Установка с помощью pip

Вам нужно использовать pip для установки dbt Core на операционных системах Windows, Linux или MacOS.

Вы можете установить dbt Core и плагины с помощью pip, потому что они являются модулями Python, распространяемыми на PyPI.

Есть ли у моей операционной системы предварительные требования?

Ваша операционная система может требовать предварительной настройки перед установкой dbt Core с помощью pip. После загрузки и установки любых зависимостей, специфичных для вашей среды разработки, вы можете продолжить с установкой dbt Core через pip.

CentOS

Для успешной установки и работы dbt Core на CentOS требуются Python и некоторые другие зависимости.

Чтобы установить Python и другие зависимости:

sudo yum install redhat-rpm-config gcc libffi-devel \
  python-devel openssl-devel

MacOS

Для успешной установки и работы dbt Core на MacOS требуется Python версии 3.8 или выше.

Чтобы проверить версию Python:

python --version

Если вам нужна совместимая версия, вы можете загрузить и установить Python версии 3.9 или выше для MacOS.

Если ваш компьютер работает на архитектуре Apple M1, мы рекомендуем установить dbt через Rosetta. Это необходимо для некоторых зависимостей, которые поддерживаются только на процессорах Intel.

Ubuntu/Debian

Для успешной установки и работы dbt Core на Ubuntu требуются Python и другие зависимости.

Чтобы установить Python и другие зависимости:

sudo apt-get install git libpq-dev python-dev python3-pip
sudo apt-get remove python-cffi
sudo pip install --upgrade cffi
pip install cryptography~=3.4

Windows

Для успешной установки и работы dbt Core на Windows требуются Python и git.

Установите Git для Windows и Python версии 3.9 или выше для Windows.

Если у вас есть дополнительные вопросы, пожалуйста, ознакомьтесь с FAQ по совместимости с Python

Какую версию Python я могу использовать?

Используйте эту таблицу, чтобы сопоставить версии dbt-core с их совместимыми версиями Python. Новые минорные версии dbt будут добавлять поддержку новых минорных версий Python3, когда все зависимости смогут их поддерживать. Кроме того, минорные версии dbt будут прекращать поддержку старых минорных версий Python3 до их окончания срока службы.

Матрица совместимости с Python

Версия dbt-core	v1.8	v1.7	v1.6	v1.5	v1.4	v1.3	v1.2	v1.1	v1.0
Python 3.12	✅	✅	❌	❌	❌	❌	❌	❌	❌
Python 3.11	✅	✅	✅	✅	✅	❌	❌	❌	❌
Python 3.10	✅	✅	✅	✅	✅	✅	✅	✅	✅
Python 3.9	✅	✅	✅	✅	✅	✅	✅	✅	✅

Плагины адаптеров и их зависимости не всегда совместимы с последней версией Python. Например, dbt-snowflake v0.19 не совместим с Python 3.9, но версии dbt-snowflake 0.20+ совместимы.

Использование виртуальных окружений

Мы рекомендуем использовать виртуальные окружения (venv) для изоляции модулей pip.

1. Создайте новое виртуальное окружение:

python -m venv dbt-env				# создайте окружение

2. Активируйте это же виртуальное окружение каждый раз, когда создаете окно или сессию оболочки:

source dbt-env/bin/activate			# активируйте окружение для Mac и Linux ИЛИ
dbt-env\Scripts\activate			# активируйте окружение для Windows

Создание алиаса

Чтобы активировать ваше окружение dbt с каждым новым окном или сессией оболочки, вы можете создать алиас для команды source в вашем $HOME/.bashrc, $HOME/.zshrc или любом другом конфигурационном файле, который использует ваша оболочка.

Например, добавьте следующее в ваш rc файл, заменив <PATH_TO_VIRTUAL_ENV_CONFIG> на путь к вашей конфигурации виртуального окружения.

alias env_dbt='source <PATH_TO_VIRTUAL_ENV_CONFIG>/bin/activate'

Установка адаптера

Как только вы решите, какой адаптер вы используете, вы можете установить его с помощью командной строки. Начиная с версии 1.8, установка адаптера не устанавливает автоматически dbt-core. Это связано с тем, что версии адаптеров и dbt Core были разделены, и мы больше не хотим перезаписывать существующие установки dbt-core.

Например, если вы используете Postgres:

Обновление адаптеров

Чтобы обновить конкретный плагин адаптера:

python -m pip install --upgrade dbt-ADAPTER_NAME

Установка только dbt-core

Если вы создаете инструмент, который интегрируется с dbt Core, вы можете установить только основную библиотеку без адаптера базы данных. Обратите внимание, что вы не сможете использовать dbt как инструмент командной строки.

python -m pip install dbt-core

Изменение версий dbt Core

Вы можете обновить или понизить версии dbt Core, используя опцию --upgrade в командной строке (CLI). Для получения дополнительной информации см. Лучшие практики обновления версий Core.

Чтобы обновить dbt до последней версии:

python -m pip install --upgrade dbt-core

Чтобы понизить до более старой версии, укажите версию, которую вы хотите использовать. Эта команда может быть полезна, когда вы решаете проблемы с зависимостями пакетов. Например:

python -m pip install --upgrade dbt-core==0.19.0

pip install dbt

Обратите внимание, что начиная с версии 1.0.0, pip install dbt больше не поддерживается, вызовет явную ошибку, и пакет dbt на PyPI перестал получать обновления. С версии 0.13 пакет PyPI с именем dbt был простым "переходником" для dbt-core и четырех оригинальных плагинов адаптеров баз данных.

Осенью 2023 года пакет dbt на PyPI стал поддерживаемым методом установки dbt Cloud CLI.

Если у вас есть рабочие процессы или интеграции, которые зависят от установки пакета с именем dbt, вы можете добиться того же поведения, установив те же пять пакетов, которые он использовал:

python -m pip install \
  dbt-core \
  dbt-postgres \
  dbt-redshift \
  dbt-snowflake \
  dbt-bigquery \
  dbt-trino

Или, что еще лучше, просто установите нужный(е) вам пакет(ы)!