Microsoft Excel

Семантический слой dbt предлагает бесшовную интеграцию с Excel Online и Desktop через пользовательское меню. Этот аддон позволяет вам создавать запросы к Семантическому слою dbt и возвращать данные по вашим метрикам непосредственно в Excel.

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

• Вы настроили Семантический слой dbt и используете dbt версии 1.6 или выше.
• У вас есть учетная запись Microsoft Excel с доступом для установки аддонов.
• У вас есть ID окружения dbt Cloud и служебный токен для аутентификации из учетной записи dbt Cloud.
• У вас должна быть учетная запись dbt Cloud Team или Enterprise account. Подходит как для многопользовательского, так и для однопользовательского развертывания.
  • Владельцы однопользовательских учетных записей должны связаться со своим представителем для необходимой настройки и активации.

подсказка

📹 Для обучения в формате видео по запросу изучите курс Запросы к Семантическому слою с помощью Excel, чтобы узнать, как выполнять запросы к метрикам с помощью Excel.

Установка аддона

Интеграция Семантического слоя dbt с Microsoft Excel доступна для загрузки непосредственно на Microsoft AppSource. Вы можете выбрать загрузку этого аддона как для Excel Desktop, так и для Excel Online.

1. В Excel выполните аутентификацию с вашим хостом, ID окружения dbt Cloud и служебным токеном.

   • Доступ к вашему ID окружения, хосту и URL-адресам можно получить в настройках Семантического слоя dbt Cloud. Создайте служебный токен в настройках Семантического слоя или настройках API токенов.
   Доступ к вашему ID окружения, хосту и URL-адресам в настройках Семантического слоя dbt Cloud. Создайте служебный токен в настройках Семантического слоя или настройках API токенов

2. Начните выполнять запросы к вашим метрикам, используя Конструктор запросов. Для получения дополнительной информации о функциях меню обратитесь к функциям Конструктора запросов. Чтобы отменить выполнение запроса, нажмите кнопку Отмена.

При выполнении запроса к вашим данным с помощью Microsoft Excel:

• Данные возвращаются в ячейку, на которую вы нажали.
• Время ожидания для запросов составляет 1 минуту.
• Если вы используете это расширение, убедитесь, что вы вошли в Microsoft с тем же профилем Excel, который использовали для настройки аддона. Входите с одним профилем за раз, так как использование нескольких профилей одновременно может вызвать проблемы.

Функции конструктора запросов

Пользовательское меню Конструктора запросов Microsoft Excel обладает следующими возможностями:

Элементы меню	Описание
Метрики	Поиск и выбор метрик.
Группировать по	Поиск и выбор измерений или сущностей для группировки. Измерения группируются по сущности семантической модели, из которой они происходят. Вы можете выбрать измерения без метрик.
Диапазон времени	Быстрый выбор временных диапазонов для просмотра данных, который применяется к основной временной серии для метрик (время метрики), или более сложная фильтрация с использованием выбора "Пользовательский".
Где	Фильтрация ваших данных. Это включает категориальные и временные фильтры.
Сортировать по	Возвращает порядок ваших данных.
Ограничение	Установите ограничение на количество строк в вашем выводе.

Примечание: Нажмите кнопку информации рядом с любой метрикой или измерением, чтобы увидеть его описание, определенное в вашем проекте dbt.

Изменение временной детализации

Когда вы выбираете временные измерения в меню Группировать по, вы увидите список доступных временных детализаций. По умолчанию выбрана самая низкая детализация. Время метрики является временным измерением по умолчанию для группировки ваших метрик.

Фильтрация данных

Чтобы использовать функцию фильтрации, выберите измерение, по которому вы хотите фильтровать, и выберите операцию, по которой вы хотите фильтровать.

• Для категориальных измерений вы можете ввести значение в поиск или выбрать из заполненного списка.
• Для сущностей вы должны ввести значение, которое вы ищете, так как мы не загружаем все из-за большого количества значений.
• Продолжайте добавлять дополнительные фильтры по мере необходимости с помощью AND и OR.
• Для временных измерений вы можете использовать селектор временного диапазона для фильтрации по предустановкам или пользовательским опциям. Селектор временного диапазона применяется только к основной временной размерности (metric_time). Для всех других временных размерностей, которые не являются metric_time, вы можете использовать опцию "Где" для применения фильтров.

Другие настройки

Если вы хотите просто запросить значения данных без заголовков, вы можете выбрать опцию Исключить названия столбцов.

Чтобы вернуть ваши результаты и сохранить любые ранее выбранные данные ниже их, снимите флажок Очистить последующие строки. По умолчанию мы очистим все последующие строки, если данные устарели.

Запустите запрос в Конструкторе запросов. Используйте стрелку рядом с кнопкой Запрос, чтобы выбрать дополнительные настройки.

Использование сохраненных выборок

Сохраненные выборки позволяют вам сохранять введенные данные, которые вы создали в Конструкторе запросов Microsoft Excel, и легко получать к ним доступ снова, чтобы не приходилось постоянно создавать общие запросы с нуля. Чтобы создать сохраненную выборку:

1. Запустите запрос в Конструкторе запросов.
2. Сохраните выборку, выбрав стрелку рядом с кнопкой Запрос, а затем выберите Запрос и сохранить выборку.
3. Приложение сохраняет эти выборки, позволяя вам просматривать и редактировать их из меню гамбургера в разделе Сохраненные выборки.

Обновление выборок

Настройте ваши сохраненные выборки на автоматическое обновление каждый раз при загрузке дополнения. Вы можете сделать это, выбрав Обновить при загрузке при создании сохраненной выборки. Когда вы получите доступ к дополнению и у вас есть сохраненные выборки, которые должны обновляться, вы увидите "Загрузка..." в ячейках, которые обновляются.

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

В чем разница между сохраненными выборками и сохраненными запросами?

• Сохраненные выборки — это сохраненные компоненты, которые вы можете создать только при использовании приложения.
• Сохраненные запросы, объясненные в следующем разделе, — это определенные в коде секции данных, которые вы создаете в вашем проекте dbt и которые вы можете легко получить и использовать для создания выборок. Вы также можете использовать результаты из сохраненного запроса для создания сохраненной выборки.

Использование сохраненных запросов

Получите доступ к сохраненным запросам, поддерживаемым MetricFlow, в Microsoft Excel, чтобы быстро получить результаты из предопределенных наборов данных. Чтобы получить доступ к сохраненным запросам в Microsoft Excel:

1. Откройте меню гамбургера в Microsoft Excel.
2. Перейдите в Сохраненные запросы, чтобы получить доступ к доступным вам.
3. Вы также можете выбрать Создать выборку, что позволяет вам исследовать существующий запрос. Это не изменит оригинальный запрос, определенный в коде.
• Если вы используете фильтр WHERE в сохраненном запросе, Microsoft Excel отображает расширенный синтаксис для этого фильтра.

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

Я получаю ошибку `Failed ALPN` при попытке подключиться к семантическому слою dbt.

Если вы получаете ошибку Failed ALPN при попытке подключиться к семантическому слою dbt с помощью различных инструментов интеграции данных (таких как Tableau, DBeaver, Datagrip, ADBC или JDBC), это обычно происходит при подключении с компьютера, находящегося за корпоративным VPN или прокси (например, Zscaler или Check Point).

Основная причина заключается в том, что прокси мешает выполнению TLS рукопожатия, так как семантический слой dbt использует gRPC/HTTP2 для подключения. Чтобы решить эту проблему:

• Если ваш прокси поддерживает gRPC/HTTP2, но не настроен на разрешение ALPN, измените его настройки, чтобы разрешить ALPN. Или создайте исключение для домена dbt Cloud.
• Если ваш прокси не поддерживает gRPC/HTTP2, добавьте исключение для перехвата SSL для домена dbt Cloud в настройках вашего прокси.

Это должно помочь успешно установить соединение без ошибки Failed ALPN.