Рабочие области и публикация
Содержание
Рабочая область — это ветка dbt-проекта: копия файлов, в которой можно менять модели, не затрагивая основную версию. Задачи по расписанию и другие участники работают с опубликованной основной рабочей областью, поэтому эксперименты безопасны.
Как это работает
- В каждом dbt-проекте есть основная рабочая область — опубликованная версия, из которой работают расписание и предпросмотр по умолчанию.
- Для правок создаётся отдельная рабочая область (ветка) со своими файлами и вкладками.
- Изменения публикуются в основную рабочую область кнопкой публикации.
- Число рабочих областей на пользователя ограничено тарифом (Лимиты и квоты).
Создание рабочей области
- Откройте переключатель рабочих областей в шапке редактора.
- Нажмите Создать и задайте название.
- Новая область создаётся копией текущей: вкладки и несохранённые изменения переносятся.
Работа в ветке
- Правки файлов живут внутри ветки: основная версия не меняется, пока не опубликована.
- Diff-вкладка показывает отличия от основной версии.
- Список изменённых файлов доступен в меню публикации.
Подтягивание изменений из основной
Если основную рабочую область обновил коллега, подтяните её изменения в свою ветку кнопкой слияния с основной. При пересечении правок одного файла возникнет конфликт — он разрешается в диалоге слияния.
Публикация
- Нажмите Опубликовать.
- Проверьте список изменённых файлов.
- Укажите комментарий к публикации.
- При желании включите компиляцию перед публикацией — SubQuery проверит, что проект собирается.
- Подтвердите публикацию: изменения сольются в основную рабочую область.
После публикации:
- в основной рабочей области появляется новая версия моделей;
- в графе моделей появляются новые связи;
- задачи по расписанию начнут использовать обновлённые модели (Задания по расписанию);
- при желании ветка удаляется вместе с публикацией.
Конфликты слияния
Если основной файл изменился с момента создания ветки, при публикации возникнет конфликт:
- SubQuery покажет список конфликтных файлов.
- Разрешите конфликт в диалоге слияния: выберите свою или основную версию, либо объедините правки.
- Повторите публикацию.
Публикацию можно прервать кнопкой отмены — ветка вернётся к состоянию до слияния.
История публикаций
В разделе публикаций видно: кто и когда публиковал, с какой ветки, комментарий и diff по каждому файлу — это журнал изменений проекта без ручного ведения Git.
Что дальше
- Профили и target — выбрать базу для рабочей области
- Тесты моделей — проверить данные перед публикацией