Доступ к интерфейсу 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 убедитесь, что выполнены предварительные требования.
- Чтобы открыть Insights, выберите Insights на боковой панели навигации.
- Если ваши учетные данные пользователя еще не настроены, Insights предложит вам настроить их. Возможность выполнять запросы к данным зависит от разрешений, предоставленных вашим учетным данным на стороне поставщика хранилища данных.
- После настройки учетных данных вы сможете писать, выполнять и редактировать 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.
Дополнительную информацию см. в разделах Часто задаваемые вопросы об ИИ в dbt, Оплата и Условия использования dbt.
- Нажмите значок dbt Copilot на боковой панели консоли запросов.
- В раскрывающемся меню над полем ввода dbt Copilot выберите Generate SQL.
- Введите запрос на естественном языке и попросите вывести количество уникальных клиентов и общую выручку с разбивкой по годам.
- Нажмите ↑, чтобы отправить запрос.
- В ответ dbt Copilot предоставит:
- Краткое описание SQL-запроса
- Объяснение логики
- Сгенерированный SQL
- Возможность добавить сгенерированный SQL к существующему запросу (Add) или заменить им существующий запрос (Replace)
- Проверьте результат и нажмите Replace, чтобы использовать сгенерированный dbt Copilot SQL в редакторе.
- Нажмите Run, чтобы просмотреть результаты.
Далее вы можете:
- Продолжить создание или изменение запроса с помощью dbt Copilot.
- Изучить результаты на вкладке Data.
- Просмотреть метаданные и сведения о запросе на вкладке Details.
- Визуализировать результаты на вкладке Chart.
- Проверить статус и предыдущие запуски в Query history.
- Использовать Catalog для изучения связей между моделями и их контекста.
- Если вы хотите сохранить запрос для дальнейшего использования, нажмите Save Insight в меню консоли запросов.
Вы можете открыть Studio IDE или Canvas из меню консоли запросов, чтобы преобразовать свой SQL в модель dbt, пригодную для повторного использования, — и всё это в dbt!
Просмотр результатов
Используя тот же пример, вы можете выполнить небольшой exploratory data analysis, запустив запрос и:
- Просмотреть результаты во вкладке Data — отображаются постраничные результаты запроса.
- Отсортировать результаты — нажмите на заголовок столбца, чтобы отсортировать данные по нему.
- Экспортировать в CSV — в правом верхнем углу таблицы нажмите кнопку загрузки, чтобы выгрузить датасет.
Просмотр подробностей
Чтобы просмотреть подробности запроса, нажмите на вкладку Details:
- Метаданные запроса — Заголовок и описание, сгенерированные dbt Copilot, исходный SQL и соответствующий скомпилированный SQL.
- Сведения о подключении — Информация о подключении к платформе данных, используемом для запроса.
- Сведения о запросе — Длительность выполнения запроса, статус, количество столбцов и строк.
Откройте вкладку Details, чтобы посмотреть детали запроса:
- Query metadata — заголовок и описание, сгенерированные , исходный SQL и соответствующий скомпилированный SQL.
- Connection details — информация о подключении к платформе данных.
- Query details — длительность выполнения, статус, количество столбцов и строк.
Визуализация результатов
Визуализируйте результаты запроса, перейдя на вкладку Chart, где можно:
- Выбрать тип графика с помощью иконки графика.
- Выбрать line chart, bar chart или scatterplot.
- Настроить оси и столбцы для визуализации с помощью иконки Chart settings.
История запросов
Просматривайте историю запросов и их статусы (All, Success, Error или Pending) с помощью иконки Query history:
- Выберите запрос, чтобы запустить его повторно и посмотреть результаты.
- Ищите прошлые запросы и фильтруйте их по статусу.
- Наведите курсор на запрос, чтобы посмотреть SQL‑код или скопировать его.
История запросов хранится бессрочно.
Откройте Catalog прямо в Insights, чтобы просматривать ресурсы проекта, такие как модели, столбцы, метрики, измерения и многое другое, — всё это доступно в интерфейсе Insights.
Это встроенное представление позволяет вам и вашим пользователям продолжать работу с запросами, получая дополнительную информацию о моделях, семантических моделях, метриках, макросах и других ресурсах. Встроенное представление Catalog предоставляет следующие возможности:
- Те же возможности поиска, что и в Catalog
- Фильтрация отображаемых объектов по типу
- Переход по гиперссылке из
refв SQL-коде на соответствующую страницу Catalog - Более подробный просмотр ресурсов в полном интерфейсе Catalog или их открытие в dbt Copilot.
Чтобы открыть Catalog, нажмите значок Catalog в боковом меню консоли запросов.
Настройка контекста Jinja
Задайте среду компиляции, чтобы управлять тем, как обрабатываются функции Jinja. Эта функция:
- Поддерживает «типизированные» среды, отмеченные как
Production,Stagingи/илиDevelopment. - Позволяет выполнять запросы Semantic Layer к средам staging (среды разработки не поддерживаются).
- По-прежнему использует учетные данные конкретного пользователя, поэтому пользователи должны иметь соответствующие права доступа для выполнения запросов к
PRODиSTG. - При смене среды меняется контекст представления Catalog в Insights, а также контекст среды при переходе в Catalog и Canvas. Например, если переключиться на
Stagingв Insights и выбрать View in Catalog, откроется представлениеStagingв Catalog.
Сохранение Insights
Insights предоставляет удобный механизм сохранения запросов, которые вы используете чаще всего. Также есть возможность делиться сохранёнными Insights с другими пользователями dbt (и получать доступ к их сохранённым запросам). Нажмите на иконку закладки в запросе, чтобы добавить его в список!
-
Нажмите иконку закладки в правом меню, чтобы управлять сохранёнными Insights. Вы можете просматривать свои личные и общие запросы.
-
Просматривайте детали сохранённого Insight, включая описание и дату создания, во вкладке Overview.
-
Просматривайте историю изменений Insight во вкладке Version history. Нажмите на версию, чтобы сравнить её с текущей и увидеть изменения.
Особенности и ограничения
Важные замечания
- Insights использует ваши учетные данные для выполнения запросов. Вы можете выполнять запросы к любому объекту в вашем хранилище данных, доступному с учетными данными пользователя, настроенными в Account settings.
- Каждая функция Jinja использует
defer --favor-stateдля разрешения ссылок Jinja.
Часто задаваемые вопросы
- В чем разница между Insights и Catalog?
- Отличный вопрос! Catalog помогает разобраться в структуре, ресурсах, связях и метриках вашего проекта dbt, предоставляя контекст для ваших данных.
- Insights опирается на этот контекст и позволяет писать, выполнять и дорабатывать SQL-запросы непосредственно в dbt. Этот инструмент предназначен для разового или исследовательского анализа и дает бизнес-пользователям и аналитикам возможность изучать данные, задавать вопросы и беспрепятственно сотрудничать.
- Catalog предоставляет контекст, а Insights позволяет действовать.







