# Доступ к интерфейсу dbt Insights

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

Узнайте, как открыть Insights, выполнять запросы и просматривать результаты.

Insights предоставляет многофункциональную консоль с навигацией по редактору. В Insights вы можете:

* Писать SQL-запросы с возможностью открывать несколько вкладок
* Использовать автодополнение SQL + dbt и подсветку синтаксиса
* Сохранять SQL-запросы
* Просматривать результаты запроса и подробные сведения о нём на вкладках **Data** или **Details**
* Создавать визуализации результатов запроса на вкладке **Chart**
* Просматривать историю запросов и их статусы (например, Success, Error, Pending) на вкладке **Query history**
* Использовать dbt Copilot в Insights для создания или редактирования SQL-запросов с помощью инструкций на естественном языке
* Использовать интеграцию с [Catalog](https://docs.getdbt.tech/docs/explore/explore-projects.md), [Studio IDE](https://docs.getdbt.tech/docs/platform/studio-ide/develop-in-studio.md) и [Canvas](https://docs.getdbt.tech/docs/platform/canvas.md) для удобного исследования данных, написания кода с помощью ИИ и совместной работы

## Доступ к интерфейсу dbt Insights

Перед началом работы с Insights убедитесь, что выполнены [предварительные требования](https://docs.getdbt.tech/docs/explore/dbt-insights.md#prerequisites).

1. Чтобы открыть Insights, выберите **Insights** на боковой панели навигации.
2. Если ваши [учетные данные пользователя](https://docs.getdbt.tech/docs/platform/studio-ide/develop-in-studio.md#get-started-with-the-studio-ide) еще не настроены, Insights предложит вам настроить их. Возможность выполнять запросы к данным зависит от разрешений, предоставленных вашим учетным данным на стороне поставщика хранилища данных.
3. После настройки учетных данных вы сможете писать, выполнять и редактировать SQL-запросы в редакторе Insights для существующих моделей вашего проекта.

## Запуск запросов

Для выполнения запросов в Insights можно использовать:

* Стандартный SQL
* Jinja (функции [`ref`](https://docs.getdbt.tech/reference/dbt-jinja-functions/ref.md), [`source`](https://docs.getdbt.tech/reference/dbt-jinja-functions/source.md) и другие функции Jinja)
* Ссылки из `ref` в SQL-коде на соответствующую страницу Explorer
* CTE и подзапросы
* Базовые агрегации и соединения
* Запросы к Semantic Layer с использованием Jinja-функций Semantic Layer

## Пример

Рассмотрим на примере, как выполнять запросы в Insights:

* Один из магазинов [Jaffle Shop](https://github.com/dbt-labs/jaffle-shop) хочет посчитать количество уникальных заказов и уникальных клиентов, чтобы понять, можно ли расширить бизнес в других регионах мира.

* Чтобы выразить эту логику в SQL, вы (аналитик, назначенный на этот проект) хотите проанализировать годовые тренды, которые помогут принять решение о расширении. Напишите следующий SQL‑запрос, чтобы вычислить количество уникальных клиентов, городов и общий доход от заказов:

  <br />

  <br />

  ```sql
  with 

  orders as (
      select * from {{ ref('orders') }}
  ),

  customers as (
      select * from {{ ref('customers') }}
  )

  select 
      date_trunc('year', ordered_at) as order_year,
      count(distinct orders.customer_id) as unique_customers,
      count(distinct orders.location_id) as unique_cities,
      to_char(sum(orders.order_total), '999,999,999.00') as total_order_revenue
  from orders
  join customers
      on orders.customer_id = customers.customer_id
  group by 1
  order by 1
  ```

### Использование dbt Copilot

Чтобы упростить работу, [используйте dbt Copilot в Insights](https://docs.getdbt.tech/docs/explore/navigate-dbt-insights.md): это поможет сэкономить время и найти другие способы анализа данных. dbt Copilot поможет быстро обновить запрос или сгенерировать новый на основе вашего описания.

dbt Wizard — рекомендуемый агент для работы с dbt

dbt Wizard — рекомендуемый ИИ-агент для разработки данных с соблюдением правил управления в dbt. Он охватывает полный цикл разработки — исследование, создание, проверку и выпуск — с опорой на граф зависимостей, тесты, контракты и определения метрик вашего проекта dbt.

Дополнительную информацию см. в разделах [Часто задаваемые вопросы об ИИ в dbt](https://docs.getdbt.tech/docs/dbt-ai/dbt-ai-faqs.md#is-dbt-wizard-the-same-as-dbt-copilot), [Оплата](https://docs.getdbt.tech/docs/dbt-ai/wizard-billing-faqs.md) и [Условия использования dbt](https://www.getdbt.com/terms-of-use).

1. Нажмите значок **dbt Copilot** на боковой панели консоли запросов.

2. В раскрывающемся меню над полем ввода dbt Copilot выберите **Generate SQL**.

3. Введите запрос на естественном языке и попросите вывести количество уникальных клиентов и общую выручку с разбивкой по годам.

4. Нажмите **↑**, чтобы отправить запрос.

5. В ответ dbt Copilot предоставит:

   * Краткое описание SQL-запроса
   * Объяснение логики
   * Сгенерированный SQL
   * Возможность добавить сгенерированный SQL к существующему запросу (**Add**) или заменить им существующий запрос (**Replace**)

6. Проверьте результат и нажмите **Replace**, чтобы использовать сгенерированный dbt Copilot SQL в редакторе.

7. Нажмите **Run**, чтобы просмотреть результаты.

[![dbt Insights с dbt Copilot](/img/docs/dbt-insights/insights-copilot.png?v=2 "dbt Insights с dbt Copilot")](#)dbt Insights с dbt Copilot

Далее вы можете:

* Продолжить создание или изменение запроса с помощью dbt Copilot.
* Изучить [результаты](#view-results) на вкладке **Data**.
* [Просмотреть метаданные и сведения о запросе](#view-details) на вкладке **Details**.
* [Визуализировать результаты](#chart-results) на вкладке **Chart**.
* Проверить статус и предыдущие запуски в [**Query history**](#query-history).
* Использовать [**Catalog**](https://docs.getdbt.tech/docs/explore/explore-projects.md) для изучения связей между моделями и их контекста.
* Если вы хотите сохранить запрос для дальнейшего использования, нажмите **Save Insight** в [меню консоли запросов](https://docs.getdbt.tech/docs/explore/navigate-dbt-insights.md#query-console-menu).

Хотите превратить запрос в модель?

Вы можете открыть [Studio IDE](https://docs.getdbt.tech/docs/platform/studio-ide/develop-in-studio.md) или [Canvas](https://docs.getdbt.tech/docs/platform/canvas.md) из [меню консоли запросов](https://docs.getdbt.tech/docs/explore/navigate-dbt-insights.md#query-console-menu), чтобы преобразовать свой SQL в модель dbt, пригодную для повторного использования, — и всё это в dbt!

### Просмотр результатов

Используя тот же пример, вы можете выполнить небольшой exploratory data analysis, запустив запрос и:

* Просмотреть результаты во вкладке **Data** — отображаются постраничные результаты запроса.
* Отсортировать результаты — нажмите на заголовок столбца, чтобы отсортировать данные по нему.
* Экспортировать в CSV — в правом верхнем углу таблицы нажмите кнопку загрузки, чтобы выгрузить датасет.

[![Экспорт в CSV в dbt Insights](/img/docs/dbt-insights/insights-export-csv.png?v=2 "Экспорт в CSV в dbt Insights")](#)Экспорт в CSV в dbt Insights

### Просмотр подробностей

Чтобы просмотреть подробности запроса, нажмите на вкладку **Details**:

* **Метаданные запроса** — Заголовок и описание, сгенерированные dbt Copilot, исходный SQL и соответствующий скомпилированный SQL.
* **Сведения о подключении** — Информация о подключении к платформе данных, используемом для запроса.
* **Сведения о запросе** — Длительность выполнения запроса, статус, количество столбцов и строк.

Откройте вкладку **Details**, чтобы посмотреть детали запроса:

* **Query metadata** — заголовок и описание, сгенерированные , исходный SQL и соответствующий скомпилированный SQL.
* **Connection details** — информация о подключении к платформе данных.
* **Query details** — длительность выполнения, статус, количество столбцов и строк.

[![Вкладка Details в dbt Insights](/img/docs/dbt-insights/insights-details.png?v=2 "Вкладка Details в dbt Insights")](#)Вкладка Details в dbt Insights

### Визуализация результатов

Визуализируйте результаты запроса, перейдя на вкладку **Chart**, где можно:

* Выбрать тип графика с помощью иконки графика.
* Выбрать **line chart, bar chart или scatterplot**.
* Настроить оси и столбцы для визуализации с помощью иконки **Chart settings**.

[![Вкладка Chart в dbt Insights](/img/docs/dbt-insights/insights-chart.png?v=2 "Вкладка Chart в dbt Insights")](#)Вкладка Chart в dbt Insights

### История запросов

Просматривайте историю запросов и их статусы (All, Success, Error или Pending) с помощью иконки **Query history**:

* Выберите запрос, чтобы запустить его повторно и посмотреть результаты.
* Ищите прошлые запросы и фильтруйте их по статусу.
* Наведите курсор на запрос, чтобы посмотреть SQL‑код или скопировать его.

История запросов хранится бессрочно.

[![Иконка Query history в dbt Insights](/img/docs/dbt-insights/insights-query-history.png?v=2 "Иконка Query history в dbt Insights")](#)Иконка Query history в dbt Insights

Откройте [Catalog](https://docs.getdbt.tech/docs/explore/explore-projects.md) прямо в Insights, чтобы просматривать ресурсы проекта, такие как модели, столбцы, метрики, измерения и многое другое, — всё это доступно в интерфейсе Insights.

Это встроенное представление позволяет вам и вашим пользователям продолжать работу с запросами, получая дополнительную информацию о моделях, семантических моделях, метриках, макросах и других ресурсах. Встроенное представление Catalog предоставляет следующие возможности:

* Те же возможности поиска, что и в Catalog
* Фильтрация отображаемых объектов по типу
* Переход по гиперссылке из `ref` в SQL-коде на соответствующую страницу Catalog
* Более подробный просмотр ресурсов в полном интерфейсе Catalog или их открытие в dbt Copilot.

Чтобы открыть Catalog, нажмите значок **Catalog** в [боковом меню консоли запросов](https://docs.getdbt.tech/docs/explore/navigate-dbt-insights.md#query-console-sidebar-menu).

[![dbt Insights, интегрированный с dbt Catalog](/img/docs/dbt-insights/insights-explorer.png?v=2 "dbt Insights, интегрированный с dbt Catalog")](#)dbt Insights, интегрированный с dbt Catalog

### Настройка контекста Jinja

Задайте среду компиляции, чтобы управлять тем, как обрабатываются функции Jinja. Эта функция:

* Поддерживает «типизированные» среды, отмеченные как `Production`, `Staging` и/или `Development`.
* Позволяет выполнять запросы Semantic Layer к средам staging (среды разработки не поддерживаются).
* По-прежнему использует учетные данные конкретного пользователя, поэтому пользователи должны иметь соответствующие права доступа для выполнения запросов к `PROD` и `STG`.
* При смене среды меняется контекст представления Catalog в Insights, а также контекст среды при переходе в Catalog и Canvas. Например, если переключиться на `Staging` в Insights и выбрать **View in Catalog**, откроется представление `Staging` в Catalog.

[![Настройка окружения для Jinja‑контекста](/img/docs/dbt-insights/insights-jinja-environment.png?v=2 "Настройка окружения для Jinja‑контекста")](#)Настройка окружения для Jinja‑контекста

## Сохранение Insights

Insights предоставляет удобный механизм сохранения запросов, которые вы используете чаще всего. Также есть возможность делиться сохранёнными Insights с другими пользователями dbt (и получать доступ к их сохранённым запросам). Нажмите на **иконку закладки** в запросе, чтобы добавить его в список!

* Нажмите **иконку закладки** в правом меню, чтобы управлять сохранёнными Insights. Вы можете просматривать свои личные и общие запросы.

  [![Управление сохранёнными Insights](/img/docs/dbt-insights/saved-insights.png?v=2 "Управление сохранёнными Insights")](#)Управление сохранёнными Insights

* Просматривайте детали сохранённого Insight, включая описание и дату создания, во вкладке **Overview**.

* Просматривайте историю изменений Insight во вкладке **Version history**. Нажмите на версию, чтобы сравнить её с текущей и увидеть изменения.

## Особенности и ограничения

## Важные замечания

* Insights использует ваши учетные данные для выполнения запросов. Вы можете выполнять запросы к любому объекту в вашем хранилище данных, доступному с учетными данными пользователя, настроенными в **Account settings**.
* Каждая функция Jinja использует [`defer --favor-state`](https://docs.getdbt.tech/reference/node-selection/defer.md) для разрешения ссылок Jinja.

## Часто задаваемые вопросы

* В чем разница между Insights и Catalog?

  * Отличный вопрос! Catalog помогает разобраться в структуре, ресурсах, связях и метриках вашего проекта dbt, предоставляя контекст для ваших данных.
  * Insights опирается на этот контекст и позволяет писать, выполнять и дорабатывать SQL-запросы непосредственно в dbt. Этот инструмент предназначен для разового или исследовательского анализа и дает бизнес-пользователям и аналитикам возможность изучать данные, задавать вопросы и беспрепятственно сотрудничать.
  * Catalog предоставляет контекст, а Insights позволяет действовать.
