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

Вход

Войдите, чтобы подключить расширение dbt для VS Code к вашей учетной записи dbt platform. Вход позволяет расширению обращаться к вашей учетной записи и использовать возможности dbt platform, такие как вкладка Catalog и сравнение изменений с отложенным разрешением ссылок (deferral) в dbt platform.

Полный список функций и сведения об их доступности приведены в разделе Возможности расширения для VS Code.

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

Вы можете войти из командной строки с помощью dbt login, доступной начиная с версии 1.13. Состояние входа может совместно использоваться разными инструментами dbt, включая расширение dbt для VS Code и, в поддерживаемых версиях, dbt State.

Выполните dbt login status, чтобы просмотреть текущий статус аутентификации.

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

  • Расширение доступно всем пользователям. Дополнительные сведения см. в Лицензионном соглашении на продукты dbt.
  • Вход связывает ваш редактор с учетной записью dbt platform, чтобы расширение могло использовать возможности dbt platform.
  • Вы можете пройти аутентификацию с помощью dbt login или войти из самого расширения. Если у вас нет учетной записи dbt platform, вы можете бесплатно создать ее в процессе аутентификации.
  • Если на вашем компьютере есть действительный файл dbt_cloud.yml, расширение может использовать его автоматически.

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

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

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

  • Срок действия сеанса истек после 7 дней бездействия. Расширение показывает сообщение: "Your dbt extension session expired. Sign in again to continue using the extension." Нажмите на уведомление или выполните dbt: Register dbt extension из палитры команд, чтобы войти снова.
  • Функции нужны более широкие права доступа, чем были предоставлены при первоначальном входе. dbt login и расширение dbt для VS Code могут запрашивать разные наборы разрешений. Если вы вошли через dbt login, а затем используете функцию расширения, которой нужны дополнительные права доступа (например, вкладку каталога или запуск задания), расширение предложит пройти повторную авторизацию. Вы пройдете ее с той же учетной записью dbt platform — вторая учетная запись не нужна.
  • Вы прошли аутентификацию с помощью dbt_cloud.yml, а не OAuth. На учетные данные из файла не распространяется правило истечения срока действия после 7 дней бездействия. Повторная аутентификация нужна только при повторном создании или удалении файла.

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

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

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

Если вы...Используйте этот способ
Начинаете аутентификацию из терминалаdbt login из командной строки.
Только начинаете работать с dbt и у вас нет учетной записи dbt platformПервый вход из расширения dbt для VS Code.
Не можете войти или вам нужно восстановить доступВосстановление доступа из расширения dbt для VS Code.
Предпочитаете аутентификацию на основе файла, чтобы не проходить ее повторноdbt_cloud.yml из расширения dbt для VS Code.

dbt login

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

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

    dbt login

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

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

    • macOS и Linux: ~/.dbt/
    • Windows: C:\Users\[username]\.dbt\
    Экран согласия Authorize VS Code Extension.Экран согласия Authorize VS Code Extension.

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

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

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

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

Подробнее о том, в каких случаях требуется повторная авторизация, см. в разделе Истечение срока действия сеанса и повторная авторизация.

Теперь расширение может обращаться к вашей учетной записи dbt platform. Подробнее о том, как dbt login работает с разными инструментами, см. в справочнике по dbt login.

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

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

 Как создать каталог .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.
  1. Клонируйте репозиторий вашего проекта dbt на локальный компьютер.
  2. Используйте команду mkdir, указав после неё имя папки, которую хотите создать.
  • Если вы используете macOS, добавьте префикс ~, чтобы создать папку .dbt в корне вашей файловой системы:
    • macOS: mkdir ~/.dbt
    • Windows: mkdir %USERPROFILE%\.dbt
 В Cursor не отображается вкладка lineage

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

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

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

  • У вас установлена последняя версия расширения dbt для VS Code.
  • У вас установлена последняя версия IDE.
  • У вас настроен корректный файл dbt_cloud.yml, который находится в правильном расположении.

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

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

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

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

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

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

  • Убедитесь, что dbt.fusionPath указывает на корректный исполняемый файл dbt v2.
  • Если вы не устанавливали dbt v2 вручную, очистите значение этого параметра, чтобы расширение само скачало исполняемый файл и управляло им.
  • Для установки вручную следуйте инструкциям в разделе Установка CLI dbt v2.
 Версия dbt v2 несовместима с этим расширением

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

  1. Выполните dbt --version, чтобы проверить установленную версию dbt v2.
  2. Сравните ее с матрицей совместимости версий для вашей версии расширения.
  3. Обновите dbt v2 или расширение так, чтобы обе версии входили в поддерживаемый диапазон. Воспользуйтесь действием Download compatible version в уведомлении, если оно отображается.
 dbt v2 аварийно завершается при запуске

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

  1. Выполните dbt --version в терминале. Если команда завершается с ошибкой, переустановите dbt v2, следуя инструкциям в разделе Установка CLI dbt v2.
  2. Воспользуйтесь действием Show Logs в уведомлении (или откройте вкладку Output), чтобы изучить ошибку запуска.
 Установлена версия dbt v2 с известными проблемами

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

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

dbt system update

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

 Устранение ошибки '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?.

 Не удается скачать манифест с платформы 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.

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

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

0
Loading