Tableau

Интеграция с Tableau позволяет использовать рабочие листы для выполнения запросов к dbt Semantic Layer напрямую и создавать панели с доверенными данными. Она обеспечивает живое подключение к dbt Semantic Layer через Tableau Desktop или Tableau Server.

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

• Вы настроили dbt Semantic Layer и используете dbt версии 1.6 или выше.
• У вас должна быть Tableau Desktop версии 2021.1 и выше или Tableau Server.
  • Обратите внимание, что Tableau Online в настоящее время не поддерживает собственные коннекторы. Если вы используете Tableau Online, вы сможете получить доступ к коннектору только в Tableau Desktop.
• Войдите в Tableau Desktop (с учетными данными Online или Server) или используйте лицензию на Tableau Server.
• Вам понадобятся ваш хост dbt Cloud, ID окружения и токен сервиса для входа. Эта учетная запись должна быть настроена с dbt Semantic Layer.
• У вас должна быть учетная запись dbt Cloud Team или Enterprise account. Подходит как для многопользовательского, так и для однопользовательского развертывания.
  • Владельцы однопользовательских учетных записей должны связаться со своим представителем для необходимой настройки и активации.

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

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

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

Установка коннектора

Коннектор dbt Semantic Layer для Tableau доступен для загрузки напрямую на Tableau Exchange.

В качестве альтернативы, вы можете следовать этим шагам для установки коннектора:

1. Загрузите файл коннектора с GitHub локально и добавьте его в вашу папку по умолчанию:

Операционная система	Tableau Desktop	Tableau Server
Windows	C:\Users\\[Windows User]\Documents\My Tableau Repository\Connectors	C:\Program Files\Tableau\Connectors
Mac	/Users/[user]/Documents/My Tableau Repository/Connectors	Не применимо
Linux	/opt/tableau/connectors	/opt/tableau/connectors

2. Установите JDBC драйвер в папку в зависимости от вашей операционной системы:
   • Windows: C:\Program Files\Tableau\Drivers
   • Mac: ~/Library/Tableau/Drivers или /Library/JDBC или ~/Library/JDBC
   • Linux: /opt/tableau/tableau_driver/jdbc
3. Откройте Tableau Desktop или Tableau Server и найдите коннектор dbt Semantic Layer by dbt Labs на левой стороне. Возможно, вам потребуется перезапустить эти приложения, чтобы коннектор стал доступен.
4. Подключитесь, используя информацию о хосте, ID окружения и токене сервиса, предоставленную dbt Cloud во время настройки Semantic Layer.
   • В Tableau Server экран аутентификации может отображать "User" и "Password", в этом случае User — это ID окружения, а пароль — это токен сервиса.

Использование интеграции

1. Аутентификация — После аутентификации система перенаправит вас на страницу источника данных.
2. Доступ ко всем объектам Semantic Layer — Используйте источник данных "ALL" для доступа ко всем метрикам, измерениям и сущностям, настроенным в вашем dbt Semantic Layer. Обратите внимание, что источник данных "METRICS_AND_DIMENSIONS" устарел и заменен на "ALL". Обязательно используйте живое подключение, так как извлечения в настоящее время не поддерживаются.
3. Доступ к сохраненным запросам — Вы можете дополнительно получить доступ к отдельным сохраненным запросам, которые вы определили. Они также будут отображаться как уникальные источники данных при входе в систему.
4. Доступ к рабочему листу — Из вашего выбора источника данных перейдите непосредственно к рабочему листу в нижнем левом углу.
5. Запрос метрик и измерений — Затем вы найдете все метрики, измерения и сущности, доступные для запроса, на левой стороне вашего окна в зависимости от вашего выбора.

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

Публикация из Tableau Desktop в Tableau Server

• Из Desktop в Server — Как и в любом рабочем процессе Tableau, вы можете опубликовать свою рабочую книгу из Tableau Desktop в Tableau Server. Для пошаговых инструкций посетите руководство по публикации от Tableau.

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

Агрегация

• Все метрики отображаются с использованием типа агрегации "SUM" в интерфейсе Tableau, и это нельзя изменить с помощью интерфейса Tableau.
• dbt Semantic Layer управляет типом агрегации в коде, и он намеренно фиксирован. Имейте в виду, что базовая агрегация в dbt Semantic Layer может не быть "SUM" ("SUM" является значением по умолчанию в Tableau).

Источники данных и отображение

• В источнике данных "ALL" Tableau отображает все метрики и измерения из dbt Semantic Layer на левой стороне. Обратите внимание, что не все метрики и измерения могут быть объединены. Вы получите сообщение об ошибке, если определенное измерение не может быть объединено с метрикой (или наоборот). Вы можете использовать сохраненные запросы для меньших частей данных, которые вы хотите объединить.
• Для отображения доступных метрик и измерений dbt Semantic Layer возвращает метаданные для фиктивной таблицы с измерениями и метриками в качестве 'столбцов' в этой таблице. Из-за этого вы не можете фактически выполнять запросы к этой таблице для предварительного просмотра или извлечений.

Вычисления и запросы

• Некоторые вычисления таблицы, такие как "Итоги" и "Процент от", могут быть неточными при использовании метрик, агрегированных неаддитивным способом (например, count distinct).
• В любом из наших интерфейсов Semantic Layer (не только в Tableau) вы должны включать временное измерение при работе с любой кумулятивной метрикой, имеющей временное окно или гранулярность.
• Мы можем поддерживать вычисляемые поля для создания фильтров параметров или динамического выбора метрик и измерений. Однако другие использования вычисляемых полей не поддерживаются.
  • Примечание: Для случаев использования вычисляемых полей, которые в настоящее время не охвачены, пожалуйста, свяжитесь с поддержкой dbt и поделитесь ими, чтобы мы могли лучше понять.
• При использовании сохраненных запросов, включающих фильтры, мы автоматически применим любые фильтры, которые есть в запросе.

Неподдерживаемая функциональность

Следующие функции Tableau в настоящее время не поддерживаются, однако dbt Semantic Layer может поддерживать некоторые из них в будущих выпусках:

• Обновление страницы источника данных
• Использование режима "Extract" для просмотра ваших данных
• Объединение таблиц
• Написание пользовательского SQL / начального SQL
• Расширения таблиц
• Кросс-базовые соединения
• Некоторые функции в Analysis --> Create Calculated Field
• Фильтрация по временной части для кумулятивного типа метрики
• Изменение вашего временного измерения на использование "Номера недели"
• Выполнение соединений между таблицами, которые создает dbt Semantic Layer. Он обрабатывает соединения за вас, поэтому нет необходимости соединять компоненты в dbt Semantic Layer. Обратите внимание, что вы можете соединять таблицы из dbt Semantic Layer с таблицами за пределами вашей платформы данных.
• Интеграция с Tableau в настоящее время не отображает описательные метки, определенные в вашей конфигурации metrics, что означает, что пользовательские метки не будут видны при импорте/запросе этих метрик в Tableau.

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

Я получаю ошибку `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.