Создание и редактирование моделей
Содержание
Модель в dbt — это SQL-файл с Jinja-конфигурацией, который превращается в таблицу или представление при запуске. В SubQuery модели создаются и редактируются в редакторе: шаблон подставляется автоматически, а запуск и публикация делаются кнопками.
Создание модели
- В дереве файлов выберите папку, куда положить модель (например,
models). - Нажмите Создать файл и задайте имя, например
orders_daily.sql. - Шаблон подставится автоматически:
{{ 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-консоль для отладки.
Что дальше
- Рабочие области и публикация — довести изменения до основной версии
- Задания по расписанию — обновлять модель автоматически