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

Платформа dbt | Enterprise, Enterprise+

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

## Доступ к Canvas

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

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

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

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

* Иметь учетную запись [dbt Enterprise или Enterprise+](https://www.getdbt.com/pricing).

* Иметь [лицензию разработчика](https://docs.getdbt.tech/docs/platform/manage-access/seats-and-users.md) с настроенными учетными данными пользователя.

* Использовать один из следующих адаптеров:

  * Bigquery
  * Databricks
  * Redshift
  * Snowflake
  * Trino

* Вы можете использовать Canvas с адаптерами, не указанными в списке, но некоторые функции могут быть пока недоступны.

* Используйте [GitHub](https://docs.getdbt.tech/docs/platform/git/connect-github.md), [GitLab](https://docs.getdbt.tech/docs/platform/git/connect-gitlab.md) или [Azure DevOps](https://docs.getdbt.tech/docs/platform/git/connect-azure-devops.md) в качестве провайдера Git, подключённого к dbt через HTTPS.

  * Подключения по SSH пока не поддерживаются.
  * Использование Canvas с самостоятельно размещёнными или локальными развёртываниями любого Git-провайдера пока не поддерживается.

* У вас должен быть уже созданный проект dbt, в котором завершён запуск в среде Staging или Production.

* Убедитесь, что ваша среда разработки использует поддерживаемый [канал выпуска](https://docs.getdbt.tech/docs/dbt-versions/dbt-release-tracks.md), чтобы регулярно получать обновления.

* У вас должен быть доступ только для чтения к [среде Staging](https://docs.getdbt.tech/docs/deploy/deploy-environments.md#staging-environment) с данными, чтобы выполнять `run` в Canvas. Подробнее о настройке необходимого доступа для группы пользователей Canvas см. в разделе [Настройка разрешений на уровне среды](https://docs.getdbt.tech/docs/platform/manage-access/environment-permissions-setup.md).

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

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

1. Перетащите [оператор](https://docs.getdbt.tech/docs/platform/canvas-interface.md#operators) с панели операторов на рабочую область.

2. Нажмите на оператор, чтобы открыть панель его настройки.

3. Просмотрите вкладки **Output** и **SQL Code**.

   * У каждого оператора есть вкладка Output, на которой можно предварительно просмотреть данные из настроенного узла.
   * На вкладке Code отображается SQL-код, сгенерированный на основе конфигурации узла. Используйте её, чтобы просмотреть SQL-код, соответствующий настройкам вашей визуальной модели.

4. Соедините операторы: перетащите курсор от начальной точки «+» одного оператора к другим операторам, с которыми хотите его связать. При этом должна появиться соединительная линия.
   * Это позволит данным проходить из исходной таблицы через настроенные вами преобразования к конечному результату.

5. Продолжайте создавать модель dbt и обязательно проверяйте результат на вкладке **Output**.

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

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

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

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

[![Отредактируйте модель с помощью кнопки «Edit a model».](/img/docs/dbt-platform/canvas/edit-model.png?v=2 "Отредактируйте модель с помощью кнопки «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. Это позволит поддерживать высокое качество данных и чётко описывать, как следует использовать ваши модели.