Подключение Tableau Desktop к ClickHouse
Подключение Tableau Desktop к ClickHouse
Как подключить приложение Tableau Desktop к ClickHouse
Tableau Desktop позволяет извлекать данные для анализа из нескольких источников, включая таблицы и базы данных. Ниже представлено, как добавить коннектор ClickHouse в Tableau Desktop, а также приведены примеры использования конкретных таблиц и SQL-запросов с книгой Tableau.
Установка
Предварительные требования
Перед установкой коннектора ClickHouse с Tableau Desktop необходимо выполнить следующие условия:
- Скачать Драйвер ODBC Clickhouse. Обратите внимание, что не нужно создавать ODBC DSN, только установить драйвер ClickHouse ODBC.
- Установить Tableau Desktop для Microsoft Windows или Apple OS X. Нужна версия 2020.2 или выше.
- Аккаунт Tableau для доступа к галерее расширений.
Установка коннектора ClickHouse
В качестве примера используется версия Tableau Desktop для Windows. Дополнительные сведения об установке коннектора Tableau см. в документации Tableau Запуск коннектора.
Установить коннектор ClickHouse для Tableau Desktop можно тремя способами:
Установка версии драйвера ODBC
clickhouse-tableau-connector-odbc позволяет пользователям вручную устанавливать ODBC-совместимый драйвер, который подключает Tableau Desktop или Tableau Server к серверу ClickHouse.
По-умолчанию, Tableau Desktop установлен по адресу в C:\Program Files\Tableau\Tableau 2021.1. Если нет, то измените этот путь в соответствии с вашей установкой Tableau Desktop.
Чтобы вручную установить ODBC-версию коннектора ClickHouse, выполните следующие действия:
- Установите драйвер ClickHouse ODBC. Дополнительную информацию см. на странице драйвера Clickhouse ODBC.
- Загрузите файл clickhouse-tableau-connector-odbc одним из следующих способов:
- В репозитории GitHub выберите Code -> Download Zip (Код -> Загрузить Zip) и извлеките ZIP-файл в папку.
- Используя следующую команду:
git clone https://github.com/Altinity/clickhouse-tableau-connector-odbc
- Создайте каталог для коннекторов Tableau. Если ими будут пользоваться только зарегистрированные пользователи, каталог должен находиться в каталоге вашего локального пользователя [username]\Documents\TableauConnectors . Например, если имя вашего пользователя – jhummel, оно будет находиться в каталоге c:\Users\jhummel\Documents\TableauConnectors.
-
Из папки clickhouse-tableau-connector-odbc скопируйте tableau_odbc_connector в папку коннекторов Tableau, созданную на предыдущем шаге.
- Например: если имя пользователя – jhummel, а каталог коннекторов Tableau находится в c:\Users\jhummel\Documents\TableauConnectors, то clickhouse-tableau-connector-odbc будет помещен в C:\Users\jhummel\Documents\TableauConnectors\tableau_odbc_connector.
- Запустите Tableau Desktop со следующими параметрами:
- Либо запустите tableau.exe из командной строки, со следующими параметрами, заменив {Каталог вашего коннектора} каталогом для ваших настраиваемых коннекторов Tableau, созданных в предыдущих шагах:
tableau.exe -DConnectPluginsPath={Каталог вашего коннектора}Например:
tableau.exe -DConnectPluginsPath=C:\Users\jhummel\Documents\TableauConnectors
Рис. 1
- Скопируйте ярлык Tableau Desktop и добавьте настраиваемую опцию каталога коннекторов Tableau после пути к tableau.exe. Например:
"C:\Program Files\Tableau\Tableau 2021.1\bin\tableau.exe" -DConnectPluginsPath=C:\Users\jhummel\Documents\TableauConnectors
Рис. 2
Скачать с Tableau
- Войти в браузере в Галерею Расширений Tableau.
- Установите версии Tableau значение 2020.3–2020.4 или 2021.1 и более поздние версии.
Рис. 3
- Выберите коннектор ClickHouse.
- На странице коннектора ClickHouse выберите Download (Загрузить) и сохраните файл clickhouse.taco.
-
Сохраните файл clickhouse.taco в каталоге пользователя [username]\Documents\My Tableau Repository\Connectors .
Например, если ваше имя пользователя – jhummel, оно будет находиться в каталоге c:\Users\jhummel\Documents\My Tableau Repository\Connectors.
- Запустите Tableau Desktop.
Установка с рабочего стола Tableau
Чтобы установить Коннектор ClickHouse из Tableau Desktop:
- Запустите Tableau Desktop.
- В главном меню выберите File -> New (Файл -> Новый).
- В главном меню выберите Dashboard -> New Dashboard (Панель -> Новая панель).
Рис. 4
- В меню Objects (Объекты) выберите Extensions (Расширения).
Рис. 5
- На панели поиска введите ClickHouse и выберите ClickHouse Connector.
- Выберите Add to Dashboard (Добавить в панель).
Подключение к ClickHouse
После установки коннектора ClickHouse к Tableau Desktop можно подключиться к серверу ClickHouse.
Чтобы подключить Tableau Desktop к серверу ClickHouse:
- Запустите Tableau Desktop.
- В меню Connect (Подключиться) выберите To a Server -> More (К серверу -> Еще).
- Выберите ClickHouse by Altinity Inc.
- Введите следующее:
Рис. 6
- Server: имя сервера базы данных ClickHouse по имени хоста или IP-адресу.
- Port: порт HTTP (8123) или HTTPS (8443).
- Database: имя используемой базы данных ClickHouse.
- Username: пользователь ClickHouse, используемый для аутентификации в базе данных.
- Пароль (опционально): пароль пользователя ClickHouse.
- Require SSL (опционально): пароль пользователя ClickHouse.
Tableau с примерами подключения ClickHouse
Tableau поддерживает несколько методов извлечения данных, от отдельных таблиц до выбора нескольких таблиц и соединяющих полей, до создания виртуальной таблицы из запроса SQL.
Чтобы получить полную информацию о таблицах Tableau, информационных панелях, диаграммах и других функциях см. Сайт документации Tableau Desktop.
Следующие примеры демонстрируют использование базы данных ClickHouse, подключенной к Tableau. В первом используется одна таблица ClickHouse, а во втором – SQL-запрос.
В этом примере мы будем использовать данные из общедоступного сервера базы данных ClickHouse, размещенного на Altinity.Cloud. Это позволяет новым пользователям ClickHouse тестировать запросы и методы подключения. Для этого образца базы данных ClickHouse используйте следующие настройки:
- Server: github.demo.trial.altinity.cloud
- Port: 8443
- Database: default
- Username: demo
- Password: Demo
- Require SSL: Enabled
Пример одиночной таблицы ClickHouse
Чтобы создать лист, заполненный данными из таблицы базы данных ClickHouse:
- Убедитесь, что коннектор ClickHouse для Tableau установлен и соединение работает. Для получения дополнительной информации см. Установка коннектора ClickHouse.
- Выберите File -> New (Файл -> Новый).
- Выберите Connect to Data (Подключиться к данным).
- Проверьте информацию о соединении, затем выберите Sign In (Войти).
- Перетащите таблицу, которая будет использоваться для листа Таблицы. Убедитесь, что выбрано Live – это означает, что Tableau будет подключаться к серверу ClickHouse по запросу, а не пытаться загрузить данные локально.
Рис. 7
-
Выберите лист внизу – обычно это будет Sheet 1 (Лист 1) для новой книги.
- В этом примере мы будем использовать таблицу ontime, в которой хранятся данные о рейсах в США.
- Выберите строки и столбцы, которые будут использоваться, перетащив их в поля Columns (Столбцы) и Rows (Строки). Наведите указатель мыши на диаграмму, которую вы хотите использовать, чтобы определить, какие параметры для нее требуются.
- Например, для Line Chart 1 (линейная диаграмма 1) тип данных должен быть Date (Дата), с одним или несколькими Dimensions (Измерениями) и одним или несколькими Measures (Мерами).
-
В этом примере:
- Выберите Flight Date (Дата полета) в качестве Column (столбца). Щелкните стрелку и выберите Year (Год), затем значок «+» и установите в следующем столбце Flight Date (Дата полета) значение Month (Месяц).
- Выберите Carrier (Носитель) в качестве строки. Щелкните стрелку и выберите Measure -> Count (Мера -> Отсчет), чтобы преобразовать это значение в меру.
Рис. 8
- В качестве типа используемой диаграммы выберите Line Chart (Линейную диаграмму).
Рис. 9
- По завершении щелкните значок сохранения и присвойте этой книге имя.
Пример SQL-запроса
Tableau может использовать SQL-запрос для создания данных для своих таблиц и диаграмм. Чтобы использовать SQL-запрос из Tableau Desktop, подключенного к серверу ClickHouse выполните следующие действия:
- Убедитесь, что коннектор ClickHouse для Tableau установлен и соединение работает. Для получения дополнительной информации см. Установка коннектора ClickHouse.
- Выберите File -> New (Файл -> Новый)
- Выберите Connect to Data. (Подключится к данным)
- Проверьте информацию о соединении, затем выберите Sign In (Войти).
-
Введите новый запрос ClickHouse SQL в текстовое поле и нажмите OK.
- В этом примере используется следующий запрос:
SELECT FlightDate, Origin, Dest,
oa.Latitude as Origin_Latitude, oa.Longitude AS Origin_Longitude,
od.Latitude as Dest_Latitude, od.Longitude AS Dest_Longitude,
Flights, Cancelled, DepDelayed, ArrDelayed
FROM (
SELECT FlightDate, Origin, Dest, count() Flights,
sum(Cancelled) Cancelled,
sum(DepDel15) DepDelayed,
sum(ArrDel15) ArrDelayed
FROM ontime
GROUP BY FlightDate, Origin, Dest ORDER BY FlightDate, Origin, Dest
) AS o
INNER JOIN airports AS oa ON toString(o.Origin) = oa.IATA
INNER JOIN airports AS od ON toString(o.Dest) = od.IATA
Рис. 10
- Выберите лист внизу (обычно это будет Sheet 1 (Лист 1)) для новой книги.
-
Выберите строки и столбцы, которые будут использоваться, перетащив их в поля Columns (Столбцы) и Rows (Строки). Проверьте диаграмму, которая будет использоваться, чтобы определить, сколько и какие значения будут использоваться.
- Например, установите в качестве столбца (Column) Origin_Longitude, а Origin_Latitude в качестве строки (Row). Щелкните стрелку и убедитесь, что это Dimensions (измерения). Выберите диаграмму Symbol Map (Карта символов). Это отобразит карту со всеми закрепленными пунктами отправления.
Рис. 11
- По завершении выберите значок сохранения и назовите свою книгу.