# Начало работы с терминалом

[Назад к гайдам](https://docs.getdbt.tech/guides.md)

[Menu ]()



## Что такое терминал?

Терминал (также называемый командной строкой, оболочкой или CLI) — это текстовый интерфейс для выполнения команд на компьютере. Многие инструменты dbt, включая dbt v2, dbt v1 и dbt Wizard CLI, работают из терминала.

Чтобы пользоваться dbt, не нужно быть экспертом по терминалу. В этом руководстве рассмотрены основы.

## Откройте терминал

### macOS

**Вариант 1: Spotlight** Нажмите `⌘ Space`, введите `Terminal` и нажмите Enter.

**Вариант 2: папка «Программы»** Откройте **Программы** → **Утилиты** → **Терминал**.

**Вариант 3: встроенный терминал VS Code** В VS Code нажмите `` ⌃` `` (Control + обратная кавычка), чтобы открыть панель терминала прямо в редакторе.

### Windows

**Вариант 1: командная строка или PowerShell** Нажмите `Win + R`, введите `cmd` или `powershell` и нажмите Enter.

**Вариант 2: Windows Terminal** Найдите «Терминал» в меню «Пуск». Windows Terminal позволяет работать с командной строкой, PowerShell и WSL в одном приложении.

**Вариант 3: встроенный терминал VS Code** В VS Code нажмите `` Ctrl+` ``, чтобы открыть панель терминала прямо в редакторе.

Используете dbt в Windows?

dbt работает непосредственно в Windows через PowerShell. Для более удобной работы рассмотрите возможность использования [WSL (подсистемы Windows для Linux)](https://learn.microsoft.com/en-us/windows/wsl/install).

### 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 перейдите в эту папку:

```bash
cd ~/path/to/your-dbt-project
```

Убедитесь, что вы находитесь в нужной папке:

```bash
ls          # macOS/Linux — вы должны увидеть dbt_project.yml
dir         # Windows
```

## Выполните первую команду dbt

После установки dbt вы можете выполнить первую команду dbt, чтобы убедиться, что инструмент установлен и работает. Перед выполнением любых команд dbt убедитесь, что вы находитесь в папке проекта:

```bash
cd ~/path/to/your-dbt-project
```

Затем выполните первую команду dbt:

```bash
dbt --version
```

Вы должны увидеть примерно такой вывод:

```bash
dbt-fusion 2.0.1
```

.... и это всё! Поздравляем, теперь вы готовы начать работу с dbt в терминале! 🎉

## Распространённые проблемы

**`command not found`** Инструмент не установлен или путь к нему не указан в переменной PATH. Ещё раз проверьте инструкции по установке [dbt v1](https://docs.getdbt.tech/docs/local/install-dbt.md) или [dbt Wizard CLI](https://docs.getdbt.tech/docs/dbt-ai/wizard-cli.md).

**`Permission denied`** Возможно, вам нужно выполнить команду с повышенными правами или проверить, разрешено ли выполнение файла.

**После ввода ничего не происходит** Убедитесь, что вы нажали **Enter** после ввода команды.

## Дальнейшие шаги

* [Установите dbt Wizard CLI](https://docs.getdbt.tech/docs/dbt-ai/wizard-cli.md) — используйте dbt Wizard CLI в терминале
* [Установите dbt](https://docs.getdbt.tech/docs/local/install-dbt.md) — настройте dbt v2 или dbt v1 локально
* [Справочник команд dbt](https://docs.getdbt.tech/reference/dbt-commands.md) — все доступные команды dbt CLI