Переход на dbt v2
После установки расширения dbt для VS Code используйте панель Get started, чтобы перевести свой проект на dbt v2, если вы еще этого не сделали.
Если вы уже используете dbt v2, для работы с инструментом перехода требуется версия 2.0.0-beta.66 или выше.
Расширение dbt предлагает два способа перевести проект на dbt v2 через панель Get started:
- Миграция с помощью агентов: Выполняет миграцию с dbt v1 на dbt v2 с помощью или ИИ-агентов. Выберите этот вариант на шаге Check dbt v2 compatibility. Требуется или ИИ-агенты.
- Ручной переход через CLI: Пошагово проводит вас через процесс перехода в терминале. Используйте этот вариант, если предпочитаете CLI или не используете или ИИ-агентов.
Миграция с помощью агентов
- Выберите Start with an agent на шаге Check dbt v2 compatibility.
- Расширение устанавливает навык агента Migrate dbt v1 to dbt v2 в папку навыков вашего редактора, а затем открывает ИИ-чат с запросом на миграцию.
- Нажмите Install & open chat, чтобы продолжить. Чат откроется с уже загруженным запросом на миграцию, поэтому вы сможете запустить его прямо из редактора. Выполнять команды CLI не требуется.
Ручной переход через CLI
На панели Get started есть помощник, который пошагово проводит вас через процесс перехода в терминале.
Панель Get started и помощник перехода в расширении dbt.Вы можете начать ручной переход любым из следующих способов:
- Через панель Get started
- Через терминал
- На панели Get started выберите Start manually in CLI на шаге Check dbt v2 compatibility.
- Следуйте указаниям помощника, чтобы завершить переход.
- Выполните
dbtf compile, чтобы убедиться, что ваш проект готов к работе с dbt v2.
Сообщение, которое появляется после завершения перехода проекта на v2.После завершения перехода вы можете приступить к изучению всех возможностей dbt v2!
Затем войдите в учетную запись dbt platform, если хотите использовать возможности dbt platform в расширении.
-
Выполните в терминале:
dbt init --v2-upgrade
Инструмент перехода проведет вас через последовательность запросов:
В некоторых случаях dbt-autofix не может устранить все ошибки и требуется ручное вмешательство. Для таких случаев инструмент dbt-autofix предоставляет файл AI Agents.md, который помогает ИИ-агентам продолжить миграцию после того, как dbt-autofix выполнит свою часть работы.
Готовы запустить dbt compile?
Инструмент компилирует ваш проект с полным статическим анализом dbt v2. Это позволяет проверить корректность вашего SQL-кода с учетом таблиц и столбцов в хранилище данных.
Сообщение, которое появляется после завершения перехода проекта на v2.После завершения перехода вы можете приступить к изучению всех возможностей dbt v2!
Затем войдите в учетную запись dbt platform, если хотите использовать возможности dbt platform в расширении.
Дальнейшие шаги
После перевода проекта на dbt v2 вы можете:
- Войти в учетную запись dbt platform, если хотите использовать возможности dbt platform в расширении, например вкладку Catalog.
- Настроить локальное окружение в соответствии с вашим окружением dbt platform и задать переменные окружения, необходимые для проекта.
- Сравнить изменения локально, чтобы предварительно оценить изменения данных, вызванные вашими локальными правками.
- Оптимизировать статический анализ для разработки и развертывания, чтобы выполнять более тщательную локальную проверку, не замедляя задания развертывания.
- Ознакомиться с ограничениями и неподдерживаемыми возможностями.
