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

Установка CLI платформы dbt

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

Совместимость CLI

dbt platform CLI — это инструмент dbt platform, доступный пользователям на любом тарифном плане. Он предназначен исключительно для работы с dbt platform и может конфликтовать с локальными установками CLI dbt v1 или dbt v2. Подробнее см. в разделе FAQs.

Команды dbt выполняются в инфраструктуре платформы, что обеспечивает следующие преимущества:

Схема взаимодействия CLI платформы dbt с инфраструктурой dbt для выполнения команд dbt из локальной командной строки.Схема взаимодействия CLI платформы dbt с инфраструктурой dbt для выполнения команд dbt из локальной командной строки.

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

dbt platform CLI доступен во всех регионах развертывания как для мультитенантных, так и для однотенантных учетных записей.

  • Если вы установили CLI dbt v1 в виртуальной среде, деактивируйте ее или создайте псевдоним для CLI платформы, прежде чем выполнять команды CLI платформы.
  • Если вы установили dbt локально, создайте псевдоним для CLI платформы, прежде чем выполнять команды CLI платформы.

Подробнее об управлении несколькими инструментами dbt platform CLI и создании псевдонима см. в разделе FAQs.

Используете CLI dbt platform для гибридной разработки с dbt v2?

См. руководство Гибридная разработка с dbt platform и dbt v2, чтобы синхронизировать учетные данные, переменные окружения и версии dbt v2 между локальным CLI и dbt platform.

Установка CLI платформы dbt​

Вы можете установить dbt platform CLI через командную строку одним из следующих способов:

Перед началом убедитесь, что Homebrew установлен и доступен в вашем редакторе кода или терминале командной строки. Если в вашей операционной системе возникают конфликты путей, см. раздел FAQs.

  1. Убедитесь, что dbt еще не установлен, выполнив следующую команду:
which dbt

Если выводится dbt not found, это подтверждает, что он не установлен.

Выполните pip uninstall dbt, чтобы удалить dbt v1

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

pip uninstall dbt

  1. Установите dbt platform CLI с помощью Homebrew:

    • Сначала удалите из Homebrew tap dbt-labs — отдельный репозиторий пакетов. Это предотвратит установку пакетов из этого репозитория через Homebrew: 
      brew untap dbt-labs/dbt
    • Затем добавьте и установите dbt platform CLI как пакет: 
      brew tap dbt-labs/dbt-cli
      brew install dbt
      Если у вас подключено несколько tap-репозиториев, используйте brew install dbt-labs/dbt-cli/dbt.

  2. Проверьте установку, выполнив dbt --help в командной строке. Если вы видите следующий вывод, установка выполнена правильно:

    The dbt CLI - an ELT tool for running SQL transformations and data models in dbt...

    Если вы не видите этот вывод, убедитесь, что вы деактивировали pyenv или venv и что у вас нет глобально установленной версии dbt.

    • Обратите внимание: при запуске среды больше не нужно выполнять команду dbt deps. Раньше этот шаг требовался для инициализации. Однако при любых изменениях в файле packages.yml по-прежнему необходимо выполнять dbt deps.

  3. Клонируйте репозиторий на локальный компьютер с помощью git clone. Например, чтобы клонировать репозиторий GitHub по HTTPS, выполните git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.

  4. После клонирования репозитория настройте dbt platform CLI для своего проекта dbt. Это позволит выполнять команды dbt, например dbt environment show для просмотра конфигурации dbt или dbt compile для компиляции проекта и проверки моделей и тестов. Вы также сможете добавлять, редактировать и синхронизировать файлы с репозиторием.

Обновление CLI платформы dbt​

Ниже приведены инструкции по обновлению dbt platform CLI до последней версии в зависимости от вашей операционной системы.

Чтобы обновить dbt platform CLI, выполните brew update, а затем brew upgrade dbt.

Особенности использования​

dbt platform CLI в настоящее время не поддерживает относительные пути в файле packages.yml. Вместо этого используйте Studio IDE, который поддерживает относительные пути в этом случае.

Ниже приведён пример конфигурации локального пакета в файле packages.yml, которая не будет работать с dbt platform CLI:

# repository_root/my_dbt_project_in_a_subdirectory/packages.yml

packages:
  - local: ../shared_macros

В этом примере ../shared_macros — это относительный путь, который указывает dbt:

  • .. — перейти на один уровень вверх (в repository_root);
  • /shared_macros — найти папку shared_macros в корневом каталоге.

Чтобы обойти это ограничение, используйте Studio IDE, который полностью поддерживает относительные пути в packages.yml.

FAQs​

 В чем разница между CLI платформы dbt и dbt?
 Как использовать и CLI платформы dbt, и dbt?
 Как создать псевдоним?
 Почему при попытке выполнить новую команду возникает ошибка `Stuck session`?
 Что делать, если в CLI платформы dbt возникает ошибка `Session occupied`?

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

0
Loading