Начало работы с терминалом
Что такое терминал?
Терминал (также называемый командной строкой, оболочкой или CLI) — это текстовый интерфейс для выполнения команд на компьютере. Многие инструменты dbt, включая dbt v2, dbt v1 и dbt Wizard CLI, работают из терминала.
Чтобы пользоваться dbt, не нужно быть экспертом по терминалу. В этом руководстве рассмотрены основы.
Откройте терминал
- macOS
- Windows
- Linux
Вариант 1: Spotlight
Нажмите ⌘ Space, введите Terminal и нажмите Enter.
Вариант 2: папка «Программы» Откройте Программы → Утилиты → Терминал.
Вариант 3: встроенный терминал VS Code
В VS Code нажмите ⌃` (Control + обратная кавычка), чтобы открыть панель терминала прямо в редакторе.
Вариант 1: командная строка или PowerShell
Нажмите Win + R, введите cmd или powershell и нажмите Enter.
Вариант 2: Windows Terminal Найдите «Терминал» в меню «Пуск». Windows Terminal позволяет работать с командной строкой, PowerShell и WSL в одном приложении.
Вариант 3: встроенный терминал VS Code
В VS Code нажмите Ctrl+`, чтобы открыть панель терминала прямо в редакторе.
dbt работает непосредственно в Windows через PowerShell. Для более удобной работы рассмотрите возможность использования WSL (подсистемы Windows для Linux).
Откройте эмулятор терминала вашего дистрибутива — обычно он находится в меню приложений. В большинстве графических сред также можно нажать Ctrl + Alt + T.
Перемещайтесь по файловой системе
Когда терминал открывается, вы находитесь в определённом каталоге (папке). Эти команды помогут перемещаться между каталогами:
| Команда | Что делает | Пример |
|---|---|---|
pwd | Выводит текущий каталог | pwd → /Users/alice |
ls | Выводит список файлов и папок (macOS/Linux) | ls |
dir | Выводит список файлов и папок (Windows) | dir |
cd <folder> | Переходит в папку | cd my-dbt-project |
cd .. | Переходит на одну папку выше | cd .. |
cd ~ | Переходит в домашний каталог | cd ~ |
Советы:
- Нажимайте Tab для автодополнения имён папок и файлов — это заметно сокращает объём ввода.
- Нажимайте ↑ / ↓ для просмотра ранее введённых команд.
- Нажмите Ctrl+C, чтобы прервать выполняющуюся команду.
Перейдите в папку проекта dbt
Проект dbt — это папка на вашем компьютере, содержащая файл dbt_project.yml. Перед выполнением любых команд dbt перейдите в эту папку:
cd ~/path/to/your-dbt-project
Убедитесь, что вы находитесь в нужной папке:
ls # macOS/Linux — вы должны увидеть dbt_project.yml
dir # Windows
Выполните первую команду dbt
После установки dbt вы можете выполнить первую команду dbt, чтобы убедиться, что инструмент установлен и работает. Перед выполнением любых команд dbt убедитесь, что вы находитесь в папке проекта:
cd ~/path/to/your-dbt-project
Затем выполните первую команду dbt:
dbt --version
Вы должны увидеть примерно такой вывод:
dbt-fusion 2.0.1
.... и это всё! Поздравляем, теперь вы готовы начать работу с dbt в терминале! 🎉
Распространённые проблемы
command not found
Инструмент не установлен или путь к нему не указан в переменной PATH. Ещё раз проверьте инструкции по установке dbt v1 или dbt Wizard CLI.
Permission denied
Возможно, вам нужно выполнить команду с повышенными правами или проверить, разрешено ли выполнение файла.
После ввода ничего не происходит Убедитесь, что вы нажали Enter после ввода команды.
Дальнейшие шаги
- Установите dbt Wizard CLI — используйте dbt Wizard CLI в терминале
- Установите dbt — настройте dbt v2 или dbt v1 локально
- Справочник команд dbt — все доступные команды dbt CLI