Рабочие области и публикация

Рабочая область — это ветка dbt-проекта: копия файлов, в которой можно менять модели, не затрагивая основную версию. Задачи по расписанию и другие участники работают с опубликованной основной рабочей областью, поэтому эксперименты безопасны.

Как это работает

  • В каждом dbt-проекте есть основная рабочая область — опубликованная версия, из которой работают расписание и предпросмотр по умолчанию.
  • Для правок создаётся отдельная рабочая область (ветка) со своими файлами и вкладками.
  • Изменения публикуются в основную рабочую область кнопкой публикации.
  • Число рабочих областей на пользователя ограничено тарифом (Лимиты и квоты).

Создание рабочей области

  1. Откройте переключатель рабочих областей в шапке редактора.
  2. Нажмите Создать и задайте название.
  3. Новая область создаётся копией текущей: вкладки и несохранённые изменения переносятся.

Работа в ветке

  • Правки файлов живут внутри ветки: основная версия не меняется, пока не опубликована.
  • Diff-вкладка показывает отличия от основной версии.
  • Список изменённых файлов доступен в меню публикации.

Подтягивание изменений из основной

Если основную рабочую область обновил коллега, подтяните её изменения в свою ветку кнопкой слияния с основной. При пересечении правок одного файла возникнет конфликт — он разрешается в диалоге слияния.

Публикация

  1. Нажмите Опубликовать.
  2. Проверьте список изменённых файлов.
  3. Укажите комментарий к публикации.
  4. При желании включите компиляцию перед публикацией — SubQuery проверит, что проект собирается.
  5. Подтвердите публикацию: изменения сольются в основную рабочую область.

После публикации:

  • в основной рабочей области появляется новая версия моделей;
  • в графе моделей появляются новые связи;
  • задачи по расписанию начнут использовать обновлённые модели (Задания по расписанию);
  • при желании ветка удаляется вместе с публикацией.

Конфликты слияния

Если основной файл изменился с момента создания ветки, при публикации возникнет конфликт:

  1. SubQuery покажет список конфликтных файлов.
  2. Разрешите конфликт в диалоге слияния: выберите свою или основную версию, либо объедините правки.
  3. Повторите публикацию.

Публикацию можно прервать кнопкой отмены — ветка вернётся к состоянию до слияния.

История публикаций

В разделе публикаций видно: кто и когда публиковал, с какой ветки, комментарий и diff по каждому файлу — это журнал изменений проекта без ручного ведения Git.

Что дальше