Создание и редактирование моделей

Модель в dbt — это SQL-файл с Jinja-конфигурацией, который превращается в таблицу или представление при запуске. В SubQuery модели создаются и редактируются в редакторе: шаблон подставляется автоматически, а запуск и публикация делаются кнопками.

Создание модели

  1. В дереве файлов выберите папку, куда положить модель (например, models).
  2. Нажмите Создать файл и задайте имя, например orders_daily.sql.
  3. Шаблон подставится автоматически:
{{ config(materialized='table') }} select    1 as id

В конфигурации указывается материализация — тип объекта, который dbt создаст в базе. В meta.owner шаблон подставляет вашу почту как владельца модели.

Материализации

Материализация Результат Когда использовать
table таблица, пересоздаётся при каждом запуске данные нужны целиком и регулярно
view представление, считается при чтении лёгкие запросы поверх сырых данных
incremental таблица с дозаписью новых данных большие объёмы, где пересоздание дорого
ephemeral подставляется как CTE в зависимые модели промежуточная логика без объекта в базе

Связь моделей через ref()

Функция ref() связывает модели: dbt строит из ссылок граф зависимостей и выполняет модели в правильном порядке.

select *from {{ ref('raw_orders') }}where date = current_date
  • запустить модель с предками — +orders_daily (сначала пересчитаются источники);
  • с потомками — orders_daily+ (после неё пересчитаются зависимые модели);
  • весь граф зависимостей виден в графе моделей.

Редактирование модели

  • Изменения сохраняются автоматически в рабочей области — основная версия не затрагивается (Рабочие области и публикация).
  • Diff-вкладка показывает отличия от опубликованной версии.
  • Проверить результат без записи в базу помогает предпросмотр (Работа в редакторе).

Компиляция

Команда компиляции показывает итоговый SQL после подстановки Jinja — так видно, во что развернулся ref() и какие значения получили переменные. Скомпилированный SQL можно скопировать в SQL-консоль для отладки.

Что дальше