# Установка расширения dbt для VS Code Локальная разработка Расширение dbt — доступное для [VS Code и Cursor](https://marketplace.visualstudio.com/items?itemName=dbtLabsInc.dbt\&ssr=false#overview), а также [Windsurf](https://open-vsx.org/extension/dbtLabsInc/dbt) — делает разработку с dbt удобнее и эффективнее. Расширение поддерживается как в dbt v1, так и в v2 — о том, какие настройки требуются для тех или иных возможностей, см. в разделе [Совместимость версий](https://docs.getdbt.tech/docs/about-dbt-extension.md#version-compatibility). примечание Это единственное официальное расширение dbt Labs для VS Code. Другие расширения *могут* работать вместе с расширением dbt для VS Code, но dbt Labs не тестирует и не поддерживает их. ## Предварительные требования Для использования расширения вам потребуется следующее: | Требование | Подробности | | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Файлы проекта** | Вам потребуется файл `profiles.yml`. Для некоторых функций dbt platform или рабочих процессов с использованием учетных данных также может потребоваться файл [`dbt_cloud.yml`](https://docs.getdbt.tech/reference/dbt_cloud.yml.md). Для использования расширения проект в dbt platform не требуется. | | **Редактор** | [VS Code](https://code.visualstudio.com/), [Cursor](https://www.cursor.com/en) или [Windsurf](https://windsurf.com/editor). | | **Операционная система** | macOS, Windows или Linux. | | **Локальная настройка** (необязательно) | [Настройте расширение](https://docs.getdbt.tech/docs/configure-dbt-extension.md), чтобы воспроизвести вашу среду dbt локально и задать все переменные окружения, необходимые для вашего проекта. | | **Поддержка миграции проекта** (необязательно) | В расширение встроен [dbt-autofix](https://github.com/dbt-labs/dbt-autofix), поэтому вы можете устранять случаи использования устаревших возможностей на панели **Problems** или в одном pull request. Вы также можете использовать навык агента **Migrate dbt v1 to dbt v2** или самостоятельно [запустить dbt-autofix](https://docs.getdbt.tech/guides/prepare-v2-upgrade.md?step=5#what-the-autofix-tool-handles). | ## Установите расширение 1. В редакторе откройте вкладку **Extensions** и найдите `dbt`. 2. Найдите расширение от издателя `dbtLabsInc` или `dbt Labs Inc`, затем нажмите **Install**. [![Поиск расширения](/img/docs/extension/extension-marketplace.png?v=2 "Поиск расширения")](#)Поиск расширения 3. Откройте проект dbt в редакторе. Убедитесь, что проект добавлен в текущую рабочую область. 4. Убедитесь, что расширение активно: в строке состояния должна отображаться надпись **dbt Extension**. Наведите указатель на эту надпись, чтобы просмотреть диагностическую информацию. [![Если отображается надпись 'dbt Extension', расширение активировано](/img/docs/extension/dbt-extension-statusbar.png?v=2 "Если отображается надпись 'dbt Extension', расширение активировано")](#)Если отображается надпись 'dbt Extension', расширение активировано 5. После активации расширение автоматически скачивает подходящий для вашей операционной системы языковой сервер dbt (LSP). [![Языковой сервер dbt будет установлен автоматически](/img/docs/extension/extension-lsp-download.png?v=2 "Языковой сервер dbt будет установлен автоматически")](#)Языковой сервер dbt будет установлен автоматически 6. Если dbt не установлен, расширение предложит скачать и установить его. Следуйте инструкциям в уведомлении или [установите его вручную из командной строки](https://docs.getdbt.tech/docs/local/install-dbt-v2.md). [![Следуйте инструкциям, чтобы установить v2](/img/docs/extension/install-dbt-v2-engine.png?v=2 "Следуйте инструкциям, чтобы установить v2")](#)Следуйте инструкциям, чтобы установить v2 7. Запустите [инструмент обновления](https://docs.getdbt.tech/docs/upgrade-to-dbt-extension.md) в расширении VS Code, чтобы проверить готовность проекта к dbt v2 и устранить ошибки или заменить устаревшие настройки. 8. Необязательно. [Настройте локальное окружение](https://docs.getdbt.tech/docs/configure-dbt-extension.md) по образцу окружения dbt platform и [задайте переменные окружения](https://docs.getdbt.tech/docs/configure-dbt-extension.md#set-environment-variables-locally), необходимые проекту. Языковой сервер входит в состав dbt v2 Языковой сервер dbt входит в состав бинарного файла v2, а не скачивается отдельно — расширение запускает его через v2. Если вы устанавливаете v2 вручную (например, в изолированной среде), а не поручаете установку расширению, воспользуйтесь [матрицей совместимости версий](https://docs.getdbt.tech/docs/dbt-versions/dbt-version-compatibility.md), чтобы выбрать бинарный файл, совместимый с версией вашего расширения. Теперь вы готовы к работе с расширением dbt. Далее вы можете: * Следовать [инструкциям по началу работы](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 v2](https://docs.getdbt.tech/docs/upgrade-to-dbt-extension.md), если вы переходите с v1. * [Войти](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md) в учетную запись dbt platform, если вы хотите использовать в расширении возможности dbt platform, например вкладку **Catalog**. * Ознакомиться с [ограничениями и неподдерживаемыми функциями](https://docs.getdbt.tech/docs/dbt/supported-features.md#limitations).  Установите dbt v2 из командной строки, если вы еще этого не сделали. Выберите предпочтительный способ установки:  Установка через pip для Windows, macOS и Linux ```shell python -m pip install dbt ``` Для обновления до более новой версии: ```shell python -m pip install --upgrade dbt ```  Автономная установка для macOS и Linux ```shell curl -fsSL https://public.cdn.getdbt.com/fs/install/install.sh | sh -s -- --update ``` Чтобы использовать `dbt` сразу после установки, закройте и снова откройте терминал или перезапустите командную оболочку, чтобы новое значение `$PATH` вступило в силу: ```shell exec $SHELL ``` Для обновления до более новой версии: ```shell dbt system update ``` примечание Команда `dbtf system update` устанавливает dbt v2 глобально — обновляет `PATH` в `~/.zshrc` и создаёт псевдоним `dbtf`. Для управления несколькими версиями или изоляции установки используйте отдельные профили командной оболочки или виртуальные окружения.  Автономная установка для Windows ```powershell irm https://public.cdn.getdbt.com/fs/install/install.ps1 | iex ``` Чтобы использовать `dbt` сразу после установки, закройте и снова откройте командную оболочку или перезапустите её, чтобы новое значение `Path` вступило в силу: ```powershell Start-Process powershell ``` Для обновления до более новой версии: ```shell dbt system update ```  Установка через Homebrew для macOS ```shell brew tap dbt-labs/dbt brew install dbt-labs/dbt/dbt ``` Для обновления до более новой версии: ```shell brew tap dbt-labs/dbt brew upgrade dbt ```  Установка через Winget для Windows ```shell winget install --id dbtLabs.dbt --exact ``` Для обновления до определённой версии: ```shell winget install --id dbtLabs.dbt --exact --version ``` Выполните следующую команду, чтобы проверить установку: ```bash dbt --version ``` Вы можете использовать `dbt` или его псевдоним `dbtf` для dbt v2 (это удобно, если у вас уже установлен другой dbt CLI). Путь установки по умолчанию: * macOS/Linux: `$HOME/.local/bin/dbt` * Windows: `C:\Users\\.local\bin\dbt.exe` Установщик добавляет этот путь автоматически, но для работы команды `dbtf` может потребоваться перезапуск командной оболочки. После установки выполните шаги из раздела [Начало работы](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 init --fusion-upgrade` для начала настройки в терминале. * Запуск команды **dbt: Register dbt extension** из палитры команд. * Выбор пункта **Get started** в меню расширения. []() ## Начало работы После установки v2 и расширения dbt для VS Code на боковой панели появляется логотип dbt. Нажмите на него, чтобы открыть панель **Get started**. Панель **Get started** — это постоянно доступный помощник по настройке в VS Code и Cursor. Она отслеживает состояние вашей среды и показывает наиболее важное следующее действие. По мере выхода новых версий v2 или изменения вашего проекта панель автоматически снова предлагает соответствующие шаги. Подробнее см. в разделе [Переход на dbt v2](https://docs.getdbt.tech/docs/upgrade-to-dbt-extension.md). [![Панель Get started в VS Code с шагами настройки и выделенным текущим шагом.](/img/docs/extension/vsce-get-started.png?v=2 "Панель Get started в VS Code с шагами настройки и выделенным текущим шагом.")](#)Панель Get started в VS Code с шагами настройки и выделенным текущим шагом. Панель помогает выполнить следующие шаги: 1. **Install or update dbt v2**: определяет, отсутствует ли исполняемый файл v2 или устарела ли его версия, и позволяет установить или обновить его одним нажатием. 2. **Open project**: проверяет наличие файла `dbt_project.yml` в вашей рабочей области, чтобы перед продолжением убедиться, что открыт корректный проект dbt. 3. **Check dbt v2 compatibility**: помогает перевести проект на v2. Вы можете выбрать миграцию с помощью ИИ-агента или ручную настройку через CLI — см. раздел [Переход на dbt v2](https://docs.getdbt.tech/docs/upgrade-to-dbt-extension.md). 4. **Sign in**: проверяет, что вы вошли в учетную запись dbt platform, которую расширение использует для доступа к возможностям dbt platform, таким как вкладка **Catalog** — см. раздел [Вход в учетную запись](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md). Когда все шаги настройки выполнены, на панели отображается зеленая кнопка **Extension setup complete**. [![Панель Get started с надписью Extension setup complete и отметками о выполнении всех четырех шагов.](/img/docs/extension/vsce-get-started-complete.png?v=2 "Панель Get started с надписью Extension setup complete и отметками о выполнении всех четырех шагов.")](#)Панель Get started с надписью Extension setup complete и отметками о выполнении всех четырех шагов. ## Следующие шаги После установки расширения dbt для VS Code: 1. [Обновите проект до dbt v2](https://docs.getdbt.tech/docs/upgrade-to-dbt-extension.md), чтобы перейти на новый движок. 2. [Войдите](https://docs.getdbt.tech/docs/sign-in-dbt-extension.md) в аккаунт dbt platform, если хотите использовать возможности платформы в расширении, например вкладку **Catalog**. 3. Ознакомьтесь с [ограничениями и неподдерживаемыми функциями](https://docs.getdbt.tech/docs/dbt/supported-features.md#limitations).