Перейти к основному содержимому

Редактирование и создание моделей dbt

Откройте Canvas и используйте его для создания и редактирования моделей dbt в визуальном интерфейсе с поддержкой перетаскивания.

Доступ к Canvas​

Перед тем как открыть редактор, убедитесь, что у вас уже настроен проект dbt. Это включает репозиторий Git, подключение к платформе данных, среды и учетные данные пользователя. Если всё это ещё не настроено, обратитесь к администратору dbt.

Открыть Canvas можно в любое время из меню слева.

Предварительные требования для Canvas​

Перед использованием Canvas необходимо:

  • Иметь учетную запись dbt Enterprise или Enterprise+.
  • Иметь лицензию разработчика с настроенными учетными данными пользователя.
  • Использовать один из следующих адаптеров:
    • Bigquery
    • Databricks
    • Redshift
    • Snowflake
    • Trino
  • Вы можете использовать Canvas с адаптерами, не указанными в списке, но некоторые функции могут быть пока недоступны.
  • Используйте GitHub, GitLab или Azure DevOps в качестве провайдера Git, подключённого к dbt через HTTPS.
    • Подключения по SSH пока не поддерживаются.
    • Использование Canvas с самостоятельно размещёнными или локальными развёртываниями любого Git-провайдера пока не поддерживается.
  • У вас должен быть уже созданный проект dbt, в котором завершён запуск в среде Staging или Production.
  • Убедитесь, что ваша среда разработки использует поддерживаемый канал выпуска, чтобы регулярно получать обновления.
  • У вас должен быть доступ только для чтения к среде Staging с данными, чтобы выполнять run в Canvas. Подробнее о настройке необходимого доступа для группы пользователей Canvas см. в разделе Настройка разрешений на уровне среды.

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

Чтобы создать SQL-модель dbt, нажмите Create a new model и выполните следующие действия. Обратите внимание: в Canvas нельзя создавать модели источников. Для этого необходим запуск в производственной среде с уже созданными источниками.

  1. Перетащите оператор с панели операторов на рабочую область.
  2. Нажмите на оператор, чтобы открыть панель его настройки.
  3. Просмотрите вкладки Output и SQL Code.
    • У каждого оператора есть вкладка Output, на которой можно предварительно просмотреть данные из настроенного узла.
    • На вкладке Code отображается SQL-код, сгенерированный на основе конфигурации узла. Используйте её, чтобы просмотреть SQL-код, соответствующий настройкам вашей визуальной модели.
  4. Соедините операторы: перетащите курсор от начальной точки «+» одного оператора к другим операторам, с которыми хотите его связать. При этом должна появиться соединительная линия.
    • Это позволит данным проходить из исходной таблицы через настроенные вами преобразования к конечному результату.
  5. Продолжайте создавать модель dbt и обязательно проверяйте результат на вкладке Output.

Редактирование существующей модели​

Чтобы отредактировать существующую модель:

  1. Перейдите в рабочую область Canvas.
  2. Нажмите +Add на верхней панели навигации.
  3. Нажмите Edit existing model.

После этого вы сможете выбрать модель, которую хотите отредактировать.

Отредактируйте модель с помощью кнопки «Edit a model».Отредактируйте модель с помощью кнопки «Edit a model».

Загрузка данных в Canvas​

Вы можете загрузить CSV-файл с исходными данными для создания модели непосредственно из Canvas:

  1. Нажмите +Add.
  2. Выберите Upload CSV source.
  3. Перетащите файл в область холста или нажмите Upload, чтобы выбрать его через файловый менеджер.

Данные будут загружены в ваше хранилище данных в виде новой таблицы в схеме разработчика. Таблица будет иметь префикс VE_UPLOADS_.

В окне canvas создаются оператор источника и базовая SQL-модель, которую можно настроить под свои задачи. Теперь вы можете работать с этими данными как в Canvas, так и в Studio IDE.

Тестирование и документация​

Тестирование и документирование моделей — важная часть процесса разработки.

Следите за обновлениями! Совсем скоро вы сможете тестировать и документировать свои модели dbt в Canvas. Это позволит поддерживать высокое качество данных и чётко описывать, как следует использовать ваши модели.

Нашли ошибку?

0
Loading