Google Sheets StarterEnterpriseEnterprise +

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

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

• Вы настроили Semantic Layer и используете dbt версии 1.6 или выше.
• Вам необходима учетная запись Google с доступом к Google Sheets и возможностью устанавливать надстройки Google.
• У вас есть Environment ID в dbt.
• У вас есть service token или personal access token для аутентификации из учетной записи dbt.
• У вас должна быть учетная запись dbt уровня Starter или Enterprise (подробнее о тарифах). Подходит как для Multi-tenant, так и для Single-tenant развертывания.

Если вы используете ограничения по IP, убедитесь, что вы добавили IP-адреса Google в свой список разрешенных IP. В противном случае подключение к Google Sheets не удастся.

📹 Узнайте о семантическом слое dbt с помощью видеокурсов по запросу!

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

Кроме того, погрузитесь в мини-курсы по запросам к семантическому слою dbt в ваших любимых инструментах: Tableau, Excel, Hex и Mode.

Установка дополнения

1. Перейдите на страницу Semantic Layer for Sheets App, чтобы установить надстройку. Также вы можете найти её прямо в Google Sheets, открыв Extensions -> Add-on -> Get add-ons и выполнив поиск там.

2. После установки откройте меню Extensions и выберите Semantic Layer for Sheets. В правой части экрана откроется пользовательское меню.

3. Найдите Host и Environment ID в dbt.

   • Перейдите в Account Settings и выберите Projects в левой боковой панели.
   • Выберите нужный проект, затем перейдите в настройки Semantic Layer. Эти данные понадобятся вам для аутентификации в Google Sheets на следующем шаге.
   • Вы можете сгенерировать service token, нажав Generate service token на странице конфигурации Semantic Layer, либо перейдя в API tokens в dbt. В качестве альтернативы вы также можете создать personal access token, перейдя в API tokens > Personal tokens.
     Access your Environment ID, Host, and URLs in your dbt Semantic Layer settings. Generate a service token in the Semantic Layer settings or API tokens settings

4. В Google Sheets выполните аутентификацию, указав ваш Host, Environment ID из dbt и service token или personal access token.

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

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

<li>Он возвращает данные в ту ячейку, по которой вы кликнули.</li>
<li>{props.bullet_1}</li>
• Если вы используете это расширение, убедитесь, что вы вошли в Chrome под тем же профилем Google, который использовался при настройке аддона. Входите только под одним профилем Google одновременно, так как одновременное использование нескольких профилей Google может привести к проблемам.
• Обратите внимание, что в настоящее время доступны только стандартные временные гранулярности; пользовательские временные гранулярности для этой интеграции пока не поддерживаются.

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

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

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

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

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

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

к сведению

Примечание: Custom time granularities (например, fiscal year) в настоящее время не поддерживаются и недоступны в рамках этой интеграции. Доступны только standard granularities (например, day, week, month и так далее). Если вам нужен доступ к пользовательским гранулярностям, рассмотрите возможность использования Semantic Layer APIs.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Раскрытие политики ограниченного использования

Использование и передача информации, полученной от Google API, Семантическим слоем dbt для Sheets будет соответствовать Политике использования данных пользователей Google API Services, включая требования ограниченного использования.

Сохранённые выборки позволяют сохранять введённые параметры в Query Builder, чтобы вы могли легко возвращаться к ним позже и не собирать часто используемые запросы каждый раз с нуля. Чтобы создать сохранённую выборку:

• Выполните запрос в Query Builder.
• Сохраните выборку, нажав на стрелку рядом с кнопкой Query, а затем выбрав Query & Save Selection.
• Приложение сохранит эти выборки, и вы сможете просматривать и редактировать их через меню «гамбургер» в разделе Saved Selections.

Вы также можете сделать эти выборки приватными или публичными:

• Public selections — ваши параметры будут доступны в меню всем пользователям листа.
• Private selections — ваши параметры будут видны только вам. Обратите внимание: любой пользователь, добавленный к листу, всё равно сможет видеть данные из этих приватных выборок, но не сможет взаимодействовать с выборкой через меню или пользоваться автоматическим обновлением.

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

Вы можете настроить автоматическое обновление сохранённых выборок каждый раз при загрузке аддона. Для этого при создании сохранённой выборки выберите Refresh on Load. Когда вы откроете аддон и у вас будут сохранённые выборки с включённым обновлением, в обновляющихся ячейках вы увидите сообщение «Loading...».

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

В чём разница между saved selections и saved queries?

• Saved selections — это сохранённые компоненты, которые можно создавать только при работе с приложением.
• Saved queries, описанные в следующем разделе, — это определённые в коде наборы данных, которые вы создаёте в своём проекте dbt и которые можно удобно использовать для построения выборок. Вы также можете использовать результаты saved query для создания saved selection.

Использование saved queries

Используйте saved queries, работающие на базе MetricFlow, чтобы быстро получать результаты из заранее определённых наборов данных. Чтобы получить доступ к saved queries в вашей интеграции:

• Откройте меню «гамбургер» в Google Sheets.
• Перейдите в Saved Queries, чтобы увидеть доступные вам запросы.
• Вы также можете выбрать Build Selection, что позволит исследовать существующий запрос. Это не изменит исходный запрос, определённый в коде.
  • Если в saved query используется where filter, Google Sheets отобразит расширенный синтаксис для этого фильтра. -->

Disclosure о политике ограниченного использования

Использование и передача Semantic Layer для Sheets, а также передача информации, полученной из Google APIs, в другие приложения осуществляется в соответствии с Google API Services User Data Policy, включая требования Limited Use.

FAQs

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

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

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

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

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

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

Создать GitHub Issue