# Вход

Локальная разработка

Войдите, чтобы подключить расширение dbt для VS Code к вашей учетной записи dbt platform. Вход позволяет расширению обращаться к вашей учетной записи и использовать возможности dbt platform, такие как [вкладка **Catalog**](https://docs.getdbt.tech/docs/dbt-extension-features.md#explore-your-catalog) и [сравнение изменений](https://docs.getdbt.tech/docs/dbt/vs-compare-changes.md) с отложенным разрешением ссылок (deferral) в dbt platform.

Полный список функций и сведения об их доступности приведены в разделе [Возможности расширения для VS Code](https://docs.getdbt.tech/docs/dbt-extension-features.md#feature-availability).

(Версии dbt: v1.13 и новее)

Вы можете войти из командной строки с помощью [`dbt login`](https://docs.getdbt.tech/reference/commands/login.md?version=2.0), доступной начиная с версии 1.13. Состояние входа может совместно использоваться разными инструментами dbt, включая расширение dbt для VS Code и, в поддерживаемых версиях, dbt State.

Выполните [`dbt login status`](https://docs.getdbt.tech/reference/commands/login.md?version=2.0#dbt-login-status), чтобы просмотреть текущий статус аутентификации.

## Основные сведения

* Расширение доступно всем пользователям. Дополнительные сведения см. в [Лицензионном соглашении на продукты dbt](https://www.getdbt.com/dbt-product-license-agreement).
* Вход связывает ваш редактор с учетной записью dbt platform, чтобы расширение могло использовать возможности dbt platform.
* Вы можете пройти аутентификацию с помощью `dbt login` или войти из самого расширения. Если у вас нет учетной записи dbt platform, вы можете бесплатно создать ее в процессе аутентификации.
* Если на вашем компьютере есть действительный файл [`dbt_cloud.yml`](https://docs.getdbt.tech/reference/dbt_cloud.yml.md), расширение может использовать его автоматически.

Если вы уже входили ранее, повторная аутентификация не потребуется, пока не истечет срок действия сеанса.

## Истечение срока действия сеанса и повторная авторизация

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

* **Срок действия сеанса истек после 7 дней бездействия.** Расширение показывает сообщение: "Your dbt extension session expired. Sign in again to continue using the extension." Нажмите на уведомление или выполните **dbt: Register dbt extension** из палитры команд, чтобы войти снова.
* **Функции нужны более широкие права доступа, чем были предоставлены при первоначальном входе.** [`dbt login`](https://docs.getdbt.tech/reference/commands/login.md?version=2.0) и расширение dbt для VS Code могут запрашивать разные наборы разрешений. Если вы вошли через `dbt login`, а затем используете функцию расширения, которой нужны дополнительные права доступа (например, вкладку каталога или запуск задания), расширение предложит пройти повторную авторизацию. Вы пройдете ее с той же учетной записью dbt platform — вторая учетная запись не нужна.
* **Вы прошли аутентификацию с помощью `dbt_cloud.yml`, а не OAuth.** На учетные данные из файла не распространяется правило истечения срока действия после 7 дней бездействия. Повторная аутентификация нужна только при повторном создании или удалении файла.

При повторной авторизации на экране согласия **Authorize dbt login** перечислены запрашиваемые права доступа. Нажмите **Allow access**, чтобы продолжить.

## Выберите способ входа

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

| Если вы...                                                                   | Используйте этот способ                                                                                                                                                |
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Начинаете аутентификацию из терминала                                        | [`dbt login`](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md?registration-path=dbt-login#choose-a-sign-in-path) из командной строки.                          |
| Только начинаете работать с dbt и у вас нет учетной записи dbt platform      | [Первый вход](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md?registration-path=first-time#choose-a-sign-in-path) из расширения dbt для VS Code.               |
| Не можете войти или вам нужно восстановить доступ                            | [Восстановление доступа](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md?registration-path=recover-login#choose-a-sign-in-path) из расширения dbt для VS Code. |
| Предпочитаете аутентификацию на основе файла, чтобы не проходить ее повторно | [`dbt_cloud.yml`](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md?registration-path=dbt-cloud-yml#choose-a-sign-in-path) из расширения dbt для VS Code.        |

### dbt login

### dbt login

Используйте этот способ, если предпочитаете терминал или хотите проходить аутентификацию один раз для CLI и расширения dbt для VS Code. Команда `dbt login` открывает в браузере тот же процесс, который запускается при выборе **dbt: Register dbt extension** в палитре команд, поэтому однократное его завершение обеспечивает аутентификацию в обоих инструментах.

1. В терминале выполните:

   ```shell
   dbt login
   ```

2. Завершите вход или регистрацию в браузере.

   * См. [Первая регистрация](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md?registration-path=first-time#first-time-registration), если вы еще не регистрировались
   * См. [Вход в существующую учетную запись](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md?registration-path=existing-account#existing-dbt-account), если у вас уже есть учетная запись dbt.
   * См. [Восстановление доступа](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md?registration-path=recover-login#recover-your-login), если вы забыли пароль или ваша учетная запись заблокирована.

3. На экране **Authorize dbt login** нажмите **Allow access**. dbt сохранит ваши учетные данные в локальном каталоге конфигурации dbt и будет использовать их для последующих команд CLI:

   * macOS и Linux: `~/.dbt/`
   * Windows: `C:\Users\[username]\.dbt\`

   [![Экран согласия Authorize VS Code Extension.](/img/docs/extension/signin-authorize-extension.png?v=2 "Экран согласия Authorize VS Code Extension.")](#)Экран согласия Authorize VS Code Extension.

4. Вернитесь в редактор и перезапустите расширение dbt для VS Code или откройте новое окно редактора.

5. Расширение обнаружит учетные данные и покажет статус **Registered**.

Предоставление дополнительных разрешений

При регистрации в расширении dbt для VS Code вам может быть предложено предоставить больше разрешений, чем при входе через CLI (или наоборот). Это ожидаемое поведение — некоторым функциям расширения требуются более широкие права доступа, чем те, которые вы предоставили при первоначальном входе. Вы можете предоставить запрашиваемые разрешения, используя ту же учетную запись dbt platform, которой уже пользуетесь, поэтому для CLI и расширения dbt для VS Code достаточно одной учетной записи.

Подробнее о том, в каких случаях требуется повторная авторизация, см. в разделе [Истечение срока действия сеанса и повторная авторизация](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md#session-expiry-and-re-authorization).

Теперь расширение может обращаться к вашей учетной записи dbt platform. Подробнее о том, как `dbt login` работает с разными инструментами, см. в [справочнике по `dbt login`](https://docs.getdbt.tech/reference/commands/login.md?version=2.0).

### Первая регистрация

### Первая регистрация

Создайте учетную запись dbt platform и подключите ее к расширению. Используйте этот способ, если вы еще ни разу не входили. Расширение и CLI открывают один и тот же процесс в браузере, поэтому начать можно из любого из этих инструментов:

* **Из расширения:** Нажмите на предложение зарегистрироваться или откройте палитру команд (Windows/Linux: Ctrl + Shift + P, macOS: Cmd + Shift + P) и выполните **dbt: Register dbt extension**.

  [![Предложение зарегистрироваться в расширении в VS Code.](/img/docs/extension/registration-prompt.png?v=2 "Предложение зарегистрироваться в расширении в VS Code.")](#)Предложение зарегистрироваться в расширении в VS Code.

* **Из CLI:** Выполните `dbt login` в терминале.

После запуска процесса выполните следующие действия в браузере:

1. На странице **Log in to dbt platform** введите адрес электронной почты и нажмите **Continue**.

2. На странице **Create your dbt platform** введите свое имя, создайте пароль, затем нажмите **Continue**. dbt создаст для вас бесплатную учетную запись.

3. На экране **Authorize dbt login** ознакомьтесь с запрашиваемыми правами доступа. Оставьте **Keep session alive** включенным, если хотите, чтобы dbt автоматически продлевал сеанс, затем нажмите **Allow access**.

   [![Экран согласия Authorize dbt login.](/img/docs/extension/signin-authorize-extension.png?v=2 "Экран согласия Authorize dbt login.")](#)Экран согласия Authorize dbt login.

4. Вернитесь в редактор. Расширение покажет статус **Registered**. Если вы начали из CLI, ваши учетные данные также сохранятся для последующих команд CLI.

5. Продолжите работу, следуя инструкциям в разделе [Начало работы](https://docs.getdbt.tech/docs/install-dbt-extension.md#%D0%BD%D0%B0%D1%87%D0%B0%D0%BB%D0%BE-%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%8B).

Предоставление дополнительных разрешений

При регистрации в расширении dbt для VS Code вам может быть предложено предоставить больше разрешений, чем при входе через CLI (или наоборот). Это ожидаемое поведение — некоторым функциям расширения требуются более широкие права доступа, чем те, которые вы предоставили при первоначальном входе. Вы можете предоставить запрашиваемые разрешения, используя ту же учетную запись dbt platform, которой уже пользуетесь, поэтому для CLI и расширения dbt для VS Code достаточно одной учетной записи.

Подробнее о том, в каких случаях требуется повторная авторизация, см. в разделе [Истечение срока действия сеанса и повторная авторизация](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md#session-expiry-and-re-authorization).

### Вход в существующую учетную запись

### Вход в существующую учетную запись

Используйте этот способ, если вы уже регистрировались, в том числе если регистрация устарела или неактивна. Расширение и CLI открывают один и тот же процесс в браузере, поэтому начать можно из любого из этих инструментов:

* **Из расширения:** [Обновите расширение для VS Code](https://code.visualstudio.com/docs/setup/setup-overview#_update-cadence) до последней версии, перезапустите редактор, затем нажмите на предложение зарегистрироваться или выполните **dbt: Register dbt extension** из палитры команд.
* **Из CLI:** Выполните `dbt login` в терминале.

После запуска процесса выполните следующие действия в браузере:

1. На странице **Sign in to dbt** введите адрес электронной почты, который вы использовали при регистрации, примите условия использования, пройдите проверку "I'm not a robot", затем нажмите **Continue**.

2. На странице **Verify your email** введите код подтверждения, отправленный dbt на вашу электронную почту, и нажмите **Continue**.

3. Если ваш адрес электронной почты связан с несколькими учетными записями, на странице выбора учетной записи выберите ту, которую хотите использовать.

4. Если для вашей учетной записи используется приложение-аутентификатор, выберите способ подтверждения личности и выполните предложенные действия.

   [![Экран подтверждения личности для учетных записей, использующих приложение-аутентификатор.](/img/docs/extension/signin-verify-identity.png?v=2 "Экран подтверждения личности для учетных записей, использующих приложение-аутентификатор.")](#)Экран подтверждения личности для учетных записей, использующих приложение-аутентификатор.

5. На экране **Authorize dbt login** ознакомьтесь с запрашиваемыми правами доступа и нажмите **Allow access**.

**Когда вам по-прежнему может понадобиться [`dbt_cloud.yml`](https://docs.getdbt.tech/reference/dbt_cloud.yml.md):**

* Вам нужны учетные данные в файле для автоматизации или отложенного разрешения ссылок (defer).
* Вы используете функции платформы, которым требуется `dbt_cloud.yml`, например Mesh или автоматическое отложенное разрешение ссылок (auto-deferral).

Предоставление дополнительных разрешений

При регистрации в расширении dbt для VS Code вам может быть предложено предоставить больше разрешений, чем при входе через CLI (или наоборот). Это ожидаемое поведение — некоторым функциям расширения требуются более широкие права доступа, чем те, которые вы предоставили при первоначальном входе. Вы можете предоставить запрашиваемые разрешения, используя ту же учетную запись dbt platform, которой уже пользуетесь, поэтому для CLI и расширения dbt для VS Code достаточно одной учетной записи.

Подробнее о том, в каких случаях требуется повторная авторизация, см. в разделе [Истечение срока действия сеанса и повторная авторизация](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md#session-expiry-and-re-authorization).

### Восстановление доступа

### Восстановление доступа

Используйте этот способ, если при входе сообщается, что у вас есть учетная запись, но вы не помните пароль.

1. На странице **Sign in to dbt** нажмите **Reset password**.
2. На экране сброса пароля введите адрес электронной почты, который вы использовали при регистрации.
3. Найдите во входящих письмо для сброса пароля и перейдите по ссылке.
4. Задайте новый пароль.
5. Вернитесь в терминал и снова выполните `dbt login`. Сброс пароля открывает отдельный сеанс в браузере, не связанный с первоначальным сеансом входа из терминала, поэтому процесс входа нужно запустить заново.
6. На странице **Sign in to dbt** войдите с помощью адреса электронной почты и только что заданного пароля, примите условия использования, пройдите проверку "I'm not a robot", затем нажмите **Continue**.
7. Если ваш адрес электронной почты связан с несколькими учетными записями, выберите ту, которую хотите использовать.
8. На экране **Authorize dbt login** нажмите **Allow access**. После завершения авторизации управление вернется в терминал и расширение dbt для VS Code.

Если войти по-прежнему не удается, ваша учетная запись может быть заблокирована. Обратитесь в [службу поддержки dbt](mailto:support@getdbt.com), чтобы разблокировать учетную запись, затем выполните действия из раздела **Вход в существующую учетную запись**.

Предоставление дополнительных разрешений

При регистрации в расширении dbt для VS Code вам может быть предложено предоставить больше разрешений, чем при входе через CLI (или наоборот). Это ожидаемое поведение — некоторым функциям расширения требуются более широкие права доступа, чем те, которые вы предоставили при первоначальном входе. Вы можете предоставить запрашиваемые разрешения, используя ту же учетную запись dbt platform, которой уже пользуетесь, поэтому для CLI и расширения dbt для VS Code достаточно одной учетной записи.

Подробнее о том, в каких случаях требуется повторная авторизация, см. в разделе [Истечение срока действия сеанса и повторная авторизация](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md#session-expiry-and-re-authorization).

### dbt\_cloud.yml

### Регистрация с помощью `dbt_cloud.yml`

Используйте этот способ, если для вашего рабочего процесса нужен файл учетных данных или если вы хотите избежать повторной аутентификации при истечении срока действия сеансов.

`dbt_cloud.yml` — отдельный, дополнительный способ аутентификации. Вам по-прежнему может понадобиться `dbt_cloud.yml` для таких функций dbt platform, как Mesh и автоматическое отложенное разрешение ссылок (auto-deferral).

1. Войдите в dbt platform.

2. Перейдите в **Account settings** → **VS Code extension**.

3. В разделе **Set up your credentials** нажмите **Download credentials**, чтобы получить файл [`dbt_cloud.yml`](https://docs.getdbt.tech/reference/dbt_cloud.yml.md).

   [![Скачивание файла dbt\_cloud.yml из вашей учетной записи на платформе dbt.](/img/docs/extension/download-registration-2.png?v=2 "Скачивание файла dbt_cloud.yml из вашей учетной записи на платформе dbt.")](#)Скачивание файла dbt\_cloud.yml из вашей учетной записи на платформе dbt.

4. Переместите файл в каталог `.dbt`:

   * macOS и Linux: `~/.dbt/dbt_cloud.yml`
   * Windows: `C:\Users\[username]\.dbt\dbt_cloud.yml`

5. Вернитесь в редактор, откройте палитру команд и выполните **dbt: Register dbt extension**.

6. Расширение обнаружит файл учетных данных и продолжит процесс регистрации.

**Особенности работы:**

* Если файл [`dbt_cloud.yml`](https://docs.getdbt.tech/reference/dbt_cloud.yml.md) существует, расширение использует его автоматически.
* Если файл отсутствует, расширение предложит войти или добавить файл.

Если ваш проект dbt использует переменные окружения, настройте их локально, чтобы расширение могло использовать те же значения, что и ваше окружение dbt. Дополнительные сведения см. в разделе [Настройка переменных окружения](https://docs.getdbt.tech/docs/configure-dbt-extension.md).

## Устранение неполадок

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

 Как создать каталог .dbt в корневом каталоге и переместить файл dbt\_cloud.yml

Если у вас ещё нет директории `.dbt`, рекомендуется выполнить следующие шаги, чтобы создать её. Если директория `.dbt` у вас уже есть, переместите файл `dbt_cloud.yml` внутрь неё. Ниже приведена справочная информация о директории `.dbt`:

* Директория `.dbt` — это скрытая папка в корне вашей файловой системы. Она используется для хранения конфигурационных файлов dbt. Префикс `.` делает папку скрытой, поэтому по умолчанию она не отображается в Finder или File Explorer.
* Чтобы увидеть скрытые файлы и папки, нажмите Command + Shift + G на macOS или Ctrl + Shift + G на Windows. Это откроет диалог «Go to Folder», в котором можно перейти к директории `.dbt`.

### Создать каталог .dbt

1. Клонируйте репозиторий вашего проекта dbt на локальный компьютер.
2. Используйте команду `mkdir`, указав после неё имя папки, которую хотите создать.

* Если вы используете macOS, добавьте префикс `~`, чтобы создать папку `.dbt` в корне вашей файловой системы:

  * macOS: `mkdir ~/.dbt`
  * Windows: `mkdir %USERPROFILE%\.dbt`

### Переместить файл dbt\_cloud.yml

Вы можете переместить файл `dbt_cloud.yml` в директорию `.dbt`, используя команду `mv`, либо просто перетащить файл мышью в папку `.dbt`, открыв папку Downloads через диалог «Go to Folder» и воспользовавшись drag-and-drop в интерфейсе.

Чтобы переместить файл с помощью терминала, используйте команду `mv` (или `move` в Windows). Эта команда перемещает `dbt_cloud.yml` из папки `Downloads` в папку `.dbt`. Если файл `dbt_cloud.yml` находится в другом месте, скорректируйте путь соответствующим образом.

#### Mac или Linux

В командной строке используйте команду `mv`, чтобы переместить файл `dbt_cloud.yml` в директорию `.dbt`. Если вы только что скачали файл `dbt_cloud.yml` и он находится в папке Downloads, команда может выглядеть так:

```bash
mv ~/Downloads/dbt_cloud.yml ~/.dbt/dbt_cloud.yml
```

#### Windows

В командной строке используйте команду `move`. Если предположить, что файл находится в папке Downloads, команда может выглядеть следующим образом:

```bash
move %USERPROFILE%\Downloads\dbt_cloud.yml %USERPROFILE%\.dbt\dbt_cloud.yml
```

 В Cursor не отображается вкладка lineage

Если вы используете расширение dbt для VS Code в Cursor, вкладка lineage лучше всего работает в режиме Editor и не отображается в режиме Agent. Если вы находитесь в режиме Agent и вкладка lineage не отображается, просто переключитесь в режим Editor, чтобы просмотреть происхождение данных на уровне таблиц и столбцов вашего проекта.

 Расширение зависает в состоянии загрузки

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

* У вас установлена последняя версия расширения dbt для VS Code.
* У вас установлена последняя версия IDE.
* У вас настроен корректный файл `dbt_cloud.yml`, который находится в [правильном расположении](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md#register-with-dbt_cloudyml).

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

* Удалите файл `dbt_cloud.yml` и скачайте его заново.
* Удалите и переустановите расширение dbt для VS Code.

 Настройки платформы dbt

Если вы используете облачную платформу dbt, у вас есть настройка `dbt-cloud:` в файле `dbt_project.yml` и вы также используете dbt Mesh, необходимо указать идентификатор проекта:

```yaml
dbt-cloud:
project-id: 12345 # Required
```

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

 Расширение dbt не активируется

Если расширение dbt успешно активировано, в строке состояния в левом нижнем углу редактора появится надпись **dbt Extension**. Чтобы просмотреть диагностическую информацию о расширении dbt, нажмите кнопку **dbt Extension**.

Если надпись **dbt Extension** отсутствует, скорее всего, расширение dbt не было установлено успешно. В этом случае попробуйте удалить расширение, перезапустить редактор, а затем установить расширение заново.

**Примечание:** В VS Code можно скрывать элементы строки состояния. Проверьте, не скрыта ли надпись dbt Extension: для этого щелкните правой кнопкой мыши по строке состояния в редакторе. Если в контекстном меню есть пункт dbt Extension, значит, расширение установлено успешно.

 Недоступны функции dbt LSP

Если вы получаете сообщение об ошибке `no active LSP for this workspace` или в редакторе недоступны функции языкового сервера dbt (LSP), такие как автодополнение, переход к определению или подсказки при наведении, сначала выполните общие действия по устранению неполадок, описанные выше.

Если вы убедились, что расширение dbt установлено корректно, но функции LSP по-прежнему недоступны, попробуйте следующее:

1. Проверьте версию расширения — убедитесь, что вы используете последнюю доступную версию расширения dbt, одним из следующих способов:

   * Откройте страницу **Extensions** в редакторе, или
   * Перейдите на вкладку **Output** и найдите номер версии, или
   * Выполните `dbtf --version` в терминале.

2. Переустановите LSP — если версия актуальна, переустановите LSP:

   1. Откройте палитру команд: Command + Shift + P (macOS) или Ctrl + Shift + P (Windows/Linux).
   2. Вставьте `dbt: Reinstall dbt LSP` и нажмите Enter.

Эта команда скачает LSP и повторно активирует расширение, чтобы устранить ошибку.

 Неподдерживаемая версия dbt

Если вы видите сообщение об ошибке, указывающее, что ваша версия dbt не поддерживается, вероятно, проблема связана с вашим окружением.

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

 Исполняемый файл dbt v2 не найден по указанному пути

Если расширение сообщает, что исполняемый файл dbt v2 не найден по указанному пути (например, `dbt-fusion binary not found at [path]`), параметр `dbt.fusionPath` указывает на расположение, в котором нет корректного исполняемого файла.

* Убедитесь, что [`dbt.fusionPath`](https://docs.getdbt.tech/docs/configure-dbt-extension.md#dbt-extension-settings) указывает на корректный исполняемый файл dbt v2.
* Если вы не устанавливали dbt v2 вручную, очистите значение этого параметра, чтобы расширение само скачало исполняемый файл и управляло им.
* Для установки вручную следуйте инструкциям в разделе [Установка CLI dbt v2](https://docs.getdbt.tech/docs/local/install-dbt.md?version=2).

 Версия dbt v2 несовместима с этим расширением

Если расширение сообщает, что установленная версия dbt v2 несовместима с вашей версией расширения dbt для VS Code, сочетание этих версий выходит за пределы поддерживаемого диапазона.

1. Выполните `dbt --version`, чтобы проверить установленную версию dbt v2.
2. Сравните ее с [матрицей совместимости версий](https://docs.getdbt.tech/docs/dbt-versions/dbt-version-compatibility.md#compatibility-matrix) для вашей версии расширения.
3. Обновите dbt v2 или расширение так, чтобы обе версии входили в поддерживаемый диапазон. Воспользуйтесь действием **Download compatible version** в уведомлении, если оно отображается.

 dbt v2 аварийно завершается при запуске

Если расширение сообщает, что dbt v2 аварийно завершился при запуске, убедитесь, что исполняемый файл запускается самостоятельно:

1. Выполните `dbt --version` в терминале. Если команда завершается с ошибкой, переустановите dbt v2, следуя инструкциям в разделе [Установка CLI dbt v2](https://docs.getdbt.tech/docs/local/install-dbt.md?version=2).
2. Воспользуйтесь действием **Show Logs** в уведомлении (или откройте вкладку **Output**), чтобы изучить ошибку запуска.

 Установлена версия dbt v2 с известными проблемами

Если расширение предупреждает, что в установленной версии dbt v2 есть известная регрессия, значит, dbt Labs пометила этот выпуск как [выпуск с известными проблемами](https://docs.getdbt.tech/docs/dbt-versions/dbt-version-compatibility.md#known-bad-releases). Обновитесь до версии, указанной в уведомлении.

Для автономных установок:

```shell
dbt system update
```

Предупреждение будет появляться и после перезапусков, пока вы не выполните обновление. Если вы работаете в изолированном окружении, обратитесь к разделу [Выпуски с известными проблемами](https://docs.getdbt.tech/docs/dbt-versions/dbt-version-compatibility.md#known-bad-releases), чтобы узнать, как распространять манифест локально.

 Устранение ошибки 'dbt language server is not running in this workspace'

Чтобы устранить ошибку `dbt language server is not running in this workspace`, необходимо добавить папку проекта dbt в рабочую область:

1. В VS Code нажмите **File** на панели инструментов, затем выберите **Add Folder to Workspace**.
2. Выберите файл проекта dbt, который хотите добавить в рабочую область.
3. Чтобы сохранить рабочую область, нажмите **File**, затем выберите **Save Workspace As**.
4. Перейдите в расположение, где хотите сохранить рабочую область.

Это должно устранить ошибку и позволить открыть проект dbt, открыв рабочую область, к которой он относится. Дополнительные сведения о рабочих областях см. в разделе [Что такое рабочая область VS Code?](https://code.visualstudio.com/docs/editing/workspaces/workspaces).

 Не удается скачать манифест с платформы dbt

Если расширение dbt для VS Code не может скачать манифест с dbt platform или при локальном использовании dbt v2 вы получаете сообщение `warning: dbt1200: Failed to download manifest`, вероятно, у вас возникли проблемы с DNS.

Чтобы проверить это, выполните DNS-запрос для хоста, с которого dbt v2 пытается скачать манифест (например, prodeu2.blob.core.windows.net), с помощью `dig` в Linux/Mac или `nslookup` в Windows.

Если запрос не возвращает IP-адрес, вероятная причина заключается в том, что ваша компания использует того же облачного провайдера с частными конечными точками для облачных ресурсов, а DNS-запросы к ним перенаправляются в частные зоны DNS.

Эту ситуацию можно исправить, настроив резервное разрешение через интернет: тогда для любого облачного хранилища, у которого в частной зоне DNS не зарегистрирован частный IP-адрес, будет возвращаться общедоступный IP-адрес.

Для Azure см. [Резервное разрешение через интернет для частных зон DNS Azure](https://learn.microsoft.com/en-us/azure/dns/private-dns-fallback).

## Дополнительная информация о dbt v2

* [Журнал изменений dbt v2](https://github.com/dbt-labs/dbt/blob/main/CHANGELOG-dbt.md)
* [О расширении dbt](https://docs.getdbt.tech/docs/about-dbt-extension.md)
* [Установка dbt v2](https://docs.getdbt.tech/docs/local/install-dbt.md)
* [Краткое руководство по началу работы с dbt v2](https://docs.getdbt.tech/guides/dbt.md?step=1)
* [Руководство по обновлению](https://docs.getdbt.tech/docs/dbt-versions/dbt-upgrade/upgrading-to-v2.md)
* [Лицензионное соглашение dbt v2](https://www.getdbt.com/dbt-fusion-engine-license-agreement)