# Microsoft Excel

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

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

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

* Вы [настроили Semantic Layer](https://docs.getdbt.tech/docs/use-dbt-semantic-layer/setup-sl.md) и используете dbt версии 1.6 или выше.
* Вам нужна учетная запись Microsoft Excel с разрешением на установку надстроек.
* У вас есть [идентификатор среды dbt](https://docs.getdbt.tech/docs/use-dbt-semantic-layer/setup-sl.md#administer-the-semantic-layer-1).
* У вас есть [служебный токен](https://docs.getdbt.tech/docs/dbt-apis/service-tokens.md) или [персональный токен доступа](https://docs.getdbt.tech/docs/dbt-apis/user-tokens.md) для аутентификации с использованием учетной записи dbt.
* У вас должна быть [учетная запись](https://www.getdbt.com/pricing) dbt с тарифным планом Starter, Enterprise или Enterprise+. Подходит как для многопользовательского (Multi-tenant), так и для однопользовательского (Single-tenant) развертывания.

подсказка

📹 Для обучения в удобное время посмотрите курс [Querying the Semantic Layer with Excel](https://learn.getdbt.com/courses/querying-the-semantic-layer-with-excel), чтобы узнать, как выполнять запросы к метрикам с помощью Excel.

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

Интеграцию Microsoft Excel для Semantic Layer можно скачать напрямую из [Microsoft AppSource](https://appsource.microsoft.com/en-us/product/office/WA200007100?tab=Overview). Вы можете установить это дополнение как для [Excel Desktop](https://pages.store.office.com/addinsinstallpage.aspx?assetid=WA200007100\&rs=en-US\&correlationId=4132ecd1-425d-982d-efb4-de94ebc83f26), так и для [Excel Online](https://pages.store.office.com/addinsinstallpage.aspx?assetid=WA200007100\&rs=en-US\&correlationid=4132ecd1-425d-982d-efb4-de94ebc83f26\&isWac=True).

1. В Excel выполните аутентификацию, используя Host, ID окружения dbt и служебный токен.

   * Найдите ID окружения, Host и URL-адреса в настройках Semantic Layer. Создайте служебный токен в настройках Semantic Layer или в разделе **API tokens**. Также можно создать персональный токен доступа, перейдя в **API tokens** > **Personal tokens**.

   [![Найдите ID окружения, Host и URL-адреса в настройках dbt Semantic Layer. Создайте служебный токен в настройках Semantic Layer или API tokens](/img/docs/dbt-platform/semantic-layer/sl-and-gsheets.png?v=2 "Найдите ID окружения, Host и URL-адреса в настройках dbt Semantic Layer. Создайте служебный токен в настройках Semantic Layer или API tokens")](#)Найдите ID окружения, Host и URL-адреса в настройках dbt Semantic Layer. Создайте служебный токен в настройках Semantic Layer или API tokens

2. Начните выполнять запросы к вашим метрикам, используя **Конструктор запросов**. Для получения дополнительной информации о функциях меню обратитесь к [функциям Конструктора запросов](#query-builder-functions). Чтобы отменить выполнение запроса, нажмите кнопку **Отмена**.

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

* Результат записывается в выбранную ячейку.
* Результаты, загрузка которых в Excel занимает больше одной минуты, не будут загружены. Это ограничение распространяется только на процесс загрузки, а не на время выполнения запроса на платформе данных.
* Если вы используете это расширение, убедитесь, что вы вошли в Microsoft с тем же профилем Excel, который использовали для настройки надстройки. Используйте только один профиль за раз, поскольку одновременное использование нескольких профилей может вызвать проблемы.
* Обратите внимание: в настоящее время доступны только стандартные уровни детализации по времени. Пользовательские уровни детализации по времени в этой интеграции пока не поддерживаются.

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

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

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

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

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

При выборе временных измерений в меню **Group By** отображается список доступных уровней детализации времени. По умолчанию выбран самый низкий уровень детализации. Metric time — временное измерение по умолчанию для группировки метрик.

к сведению

Примечание: [Пользовательские уровни детализации времени](https://docs.getdbt.tech/docs/build/metricflow-time-spine.md#add-custom-granularities) (например, финансовый год) в настоящее время не поддерживаются и недоступны в этой интеграции. Доступны только [стандартные уровни детализации](https://docs.getdbt.tech/docs/build/dimensions.md?dimension=time_gran#time) (например, день, неделя, месяц и так далее). Если вам нужен доступ к пользовательским уровням детализации, рассмотрите возможность использования [API семантического слоя](https://docs.getdbt.tech/docs/dbt-apis/sl-api-overview.md).

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

Чтобы использовать функцию фильтрации, выберите [измерение](https://docs.getdbt.tech/docs/build/dimensions.md), по которому вы хотите фильтровать, и выберите операцию, по которой вы хотите фильтровать.

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

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

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

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

[![Запустите запрос в Конструкторе запросов. Используйте стрелку рядом с кнопкой Запрос, чтобы выбрать дополнительные настройки.](/img/docs/dbt-platform/semantic-layer/query-builder.png?v=2 "Запустите запрос в Конструкторе запросов. Используйте стрелку рядом с кнопкой Запрос, чтобы выбрать дополнительные настройки.")](#)Запустите запрос в Конструкторе запросов. Используйте стрелку рядом с кнопкой Запрос, чтобы выбрать дополнительные настройки.

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

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

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

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

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

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

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

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

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

Получите доступ к [сохраненным запросам](https://docs.getdbt.tech/docs/build/saved-queries.md), поддерживаемым MetricFlow, в Microsoft Excel, чтобы быстро получить результаты из предопределенных наборов данных. Чтобы получить доступ к сохраненным запросам в Microsoft Excel:

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

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

Я получаю ошибку \`Failed ALPN\` при попытке подключения к dbt Semantic Layer

Если при попытке подключить dbt Semantic Layer к различным [инструментам интеграции данных](https://docs.getdbt.tech/docs/platform-integrations/avail-sl-integrations.md) (например, Tableau, DBeaver, Datagrip, ADBC или JDBC) вы получаете ошибку `Failed ALPN`, обычно это происходит при подключении с компьютера, находящегося за корпоративным VPN или прокси-сервером (например, Zscaler или Check Point).

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

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

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