Tableau
Интеграция с Tableau позволяет использовать рабочие листы для выполнения запросов напрямую к Semantic Layer и создавать дашборды на основе доверенных данных. Она обеспечивает живое подключение к Semantic Layer через Tableau Desktop или Tableau Server.
Предварительные требования
- Вы настроили Semantic Layer и используете dbt версии 1.6 или выше.
- У вас должен быть Tableau Desktop версии 2021.1 или выше, Tableau Server или Tableau Cloud.
- Войдите в Tableau Desktop (с учётными данными Cloud или Server) или Tableau Cloud. Вы также можете использовать лицензированное развёртывание Tableau Server.
- Для входа вам понадобятся хост dbt, идентификатор среды и сервисный токен или персональный токен доступа. Эта учётная запись должна быть настроена для работы с Semantic Layer.
- У вас должна быть учётная запись dbt на тарифе Starter или Enterprise. Поддерживаются как многопользовательские (Multi-tenant), так и однопользовательские (Single-tenant) развёртывания.
📹 Узнайте о семантическом слое dbt с помощью видеокурсов по запросу!
Изучите наш курс по семантическому слою dbt, чтобы узнать, как определять и запрашивать метрики в вашем проекте dbt.
Кроме того, погрузитесь в мини-курсы по запросам к семантическому слою dbt в ваших любимых инструментах: Tableau, Excel, Hex и Mode.
Установка коннектора
Коннектор Tableau для Semantic Layer доступен для загрузки напрямую на Tableau Exchange. Коннектор поддерживается в Tableau Desktop, Tableau Server и Tableau Cloud.
В качестве альтернативы вы можете выполнить следующие шаги для установки коннектора. Обратите внимание, что эти шаги применимы только к Tableau Desktop и Tableau Server. Коннектор для Tableau Cloud управляется самой Tableau.
- Загрузите файл коннектора с 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 |
- Установите драйвер JDBC в папку, соответствующую вашей операционной системе:
- Windows:
C:\Program Files\Tableau\Drivers - Mac:
~/Library/Tableau/Driversили/Library/JDBCили~/Library/JDBC - Linux:
/opt/tableau/tableau_driver/jdbc
- Windows:
- Откройте Tableau Desktop или Tableau Server и найдите коннектор Semantic Layer by dbt Labs в левой части окна. Возможно, потребуется перезапустить эти приложения, чтобы коннектор стал доступен.
- Подключитесь, используя Host, Environment ID и служебный или персональный токен, которые dbt предоставляет при настройке Semantic Layer.
- В Tableau Server на экране аутентификации вместо этого могут отображаться поля "User" и "Password". В этом случае в поле User укажите Environment ID, а в поле Password — Service Token.
Использование интеграции
- Аутентификация — После аутентификации система перенаправит вас на страницу источника данных.
- Доступ ко всем объектам Semantic Layer — Используйте источник данных "ALL", чтобы получить доступ ко всем метрикам, измерениям и сущностям, настроенным в вашем Semantic Layer. Обратите внимание, что источник данных "METRICS_AND_DIMENSIONS" был признан устаревшим и заменён на "ALL". Обязательно используйте живое подключение, так как извлечения (extracts) в настоящее время не поддерживаются.
- Доступ к сохранённым запросам — При необходимости вы можете получить доступ к отдельным сохранённым запросам, которые вы определили. Они также будут отображаться как отдельные источники данных при входе в систему.
- Доступ к рабочему листу — На экране выбора источника данных перейдите напрямую к рабочему листу, используя элемент в левом нижнем углу.
- Запрос метрик и измерений — После этого в левой части окна вы увидите все метрики, измерения и сущности, доступные для запросов, в зависимости от выбранного источника.
Посетите документацию Tableau, чтобы узнать больше о том, как использовать рабочие листы и панели Tableau.
Публикация из Tableau Desktop на Tableau Server
- Из Desktop в Server — Как и в любом рабочем процессе Tableau, вы можете опубликовать свою рабочую книгу из Tableau Desktop в Tableau Server. Для пошаговых инструкций посетите руководство по публикации от Tableau.
Изменение временной гранулярности
При выборе временных измерений в меню Group By отображается список доступных уровней детализации времени. По умолчанию выбран самый низкий уровень детализации. Metric time — временное измерение по умолчанию для группировки метрик.
Примечание: Пользовательские уровни детализации времени (например, финансовый год) в настоящее время не поддерживаются и недоступны в этой интеграции. Доступны только стандартные уровни детализации (например, день, неделя, месяц и так далее). Если вам нужен доступ к пользовательским уровням детализации, рассмотрите возможность использования API семантического слоя.
На что следует обратить внимание
Агрегация
- Все метрики в интерфейсе Tableau отображаются как использующие тип агрегации «SUM», и это нельзя изменить средствами интерфейса Tableau.
- Тип агрегации на уровне кода контролируется в Semantic Layer и намеренно зафиксирован. При этом важно помнить, что фактическая агрегация в Semantic Layer может быть не «SUM» (так как «SUM» — это значение по умолчанию в Tableau).
Источники данных и отображение
- В источнике данных «ALL» Tableau отображает все метрики и измерения из Semantic Layer в левой панели. Обратите внимание, что не все метрики и измерения можно комбинировать между собой. Если конкретное измерение нельзя использовать для разреза метрики (или наоборот), вы получите сообщение об ошибке. Для объединения меньших наборов данных можно использовать сохранённые запросы.
- Чтобы отобразить доступные метрики и измерения, Semantic Layer возвращает метаданные для фиктивной таблицы, в которой измерения и метрики представлены как «столбцы». По этой причине вы не можете выполнять запросы к этой таблице для предпросмотра или создания extract’ов.
Вычисления и запросы
- Некоторые табличные вычисления Tableau, такие как «Totals» и «Percent Of», могут быть неточными при использовании метрик с неаддитивной агрегацией (например, count distinct).
- В любом из интерфейсов Semantic Layer (не только в Tableau) при работе с любой кумулятивной метрикой, имеющей временное окно или гранулярность, необходимо включать time dimension.
- Мы поддерживаем вычисляемые поля для создания фильтров на основе параметров или для динамического выбора метрик и измерений. Однако другие сценарии использования вычисляемых полей не поддерживаются.
- Примечание: если у вас есть сценарии использования вычисляемых полей, которые в настоящее время не поддерживаются, пожалуйста, свяжитесь с службой поддержки dbt и опишите их, чтобы мы могли лучше понять ваши потребности.
- При использовании сохранённых запросов, содержащих фильтры, мы автоматически применяем все фильтры, заданные в этом запросе.
Неподдерживаемая функциональность
Следующие возможности Tableau в настоящее время не поддерживаются. Однако Semantic Layer может поддержать часть этой функциональности в будущих версиях:
- Обновление страницы источника данных
- Использование режима "Extract" для просмотра данных
- Объединение таблиц (Unioning Tables)
- Написание пользовательского SQL / Initial SQL
- Расширения таблиц (Table Extensions)
- Кросс-базовые соединения (Cross-Database Joins)
- Некоторые функции в меню Analysis --> Create Calculated Field
- Фильтрация по части даты (Date Part) для метрик кумулятивного типа
- Изменение измерения даты на использование "Week Number"
- Выполнение соединений между таблицами, которые создаёт Semantic Layer. Он сам управляет соединениями, поэтому нет необходимости соединять компоненты внутри Semantic Layer. Обратите внимание: вы можете соединять таблицы из Semantic Layer с таблицами вне вашей платформы данных.
- Интеграция с Tableau в настоящее время не отображает описательные метки, определённые в конфигурации
metrics. Это означает, что пользовательские метки не будут видны при импорте или запросе этих метрик в Tableau.
