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

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

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

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

  • Писать SQL-запросы с возможностью открывать несколько вкладок
  • Использовать автодополнение SQL + dbt и подсветку синтаксиса
  • Сохранять SQL-запросы
  • Просматривать результаты запроса и подробные сведения о нём на вкладках Data или Details
  • Создавать визуализации результатов запроса на вкладке Chart
  • Просматривать историю запросов и их статусы (например, Success, Error, Pending) на вкладке Query history
  • Использовать dbt Copilot в Insights для создания или редактирования SQL-запросов с помощью инструкций на естественном языке
  • Использовать интеграцию с Catalog, Studio IDE и Canvas для удобного исследования данных, написания кода с помощью ИИ и совместной работы

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

Перед началом работы с Insights убедитесь, что выполнены предварительные требования.

  1. Чтобы открыть Insights, выберите Insights на боковой панели навигации.
  2. Если ваши учетные данные пользователя еще не настроены, Insights предложит вам настроить их. Возможность выполнять запросы к данным зависит от разрешений, предоставленных вашим учетным данным на стороне поставщика хранилища данных.
  3. После настройки учетных данных вы сможете писать, выполнять и редактировать SQL-запросы в редакторе Insights для существующих моделей вашего проекта.

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

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

  • Стандартный SQL
  • Jinja (функции ref, source и другие функции Jinja)
  • Ссылки из ref в SQL-коде на соответствующую страницу Explorer
  • CTE и подзапросы
  • Базовые агрегации и соединения
  • Запросы к Semantic Layer с использованием Jinja-функций Semantic Layer

Пример​

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

  • Один из магазинов Jaffle Shop хочет посчитать количество уникальных заказов и уникальных клиентов, чтобы понять, можно ли расширить бизнес в других регионах мира.
  • Чтобы выразить эту логику в SQL, вы (аналитик, назначенный на этот проект) хотите проанализировать годовые тренды, которые помогут принять решение о расширении. Напишите следующий 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: это поможет сэкономить время и найти другие способы анализа данных. dbt Copilot поможет быстро обновить запрос или сгенерировать новый на основе вашего описания.

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

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

Дополнительную информацию см. в разделах Часто задаваемые вопросы об ИИ в dbt, Оплата и Условия использования dbt.

  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 Copilotdbt Insights с dbt Copilot

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

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

Вы можете открыть Studio IDE или Canvas из меню консоли запросов, чтобы преобразовать свой SQL в модель dbt, пригодную для повторного использования, — и всё это в dbt!

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Иконка Query history в dbt InsightsИконка Query history в dbt Insights

Откройте Catalog прямо в Insights, чтобы просматривать ресурсы проекта, такие как модели, столбцы, метрики, измерения и многое другое, — всё это доступно в интерфейсе Insights.

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

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

Чтобы открыть Catalog, нажмите значок Catalog в боковом меню консоли запросов.

dbt Insights, интегрированный с dbt Catalogdbt 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‑контекстаНастройка окружения для Jinja‑контекста

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

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

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

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

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

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

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

  • Insights использует ваши учетные данные для выполнения запросов. Вы можете выполнять запросы к любому объекту в вашем хранилище данных, доступному с учетными данными пользователя, настроенными в Account settings.
  • Каждая функция Jinja использует defer --favor-state для разрешения ссылок Jinja.

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

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

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

0
Loading