Подключение Tableau к ClickHouse

ClickHouse предлагает официальный коннектор Tableau, доступный на Tableau Exchange. Коннектор основан на современном JDBC-драйвере для ClickHouse.

С помощью этого коннектора Tableau использует базы данных и таблицы ClickHouse в качестве источников данных. Чтобы включить эту возможность, следуйте приведенному ниже руководству по настройке.

1. Подготовьте сведения о подключении

   Чтобы подключиться к ClickHouse по HTTP(S), вам понадобится следующая информация:

   Параметр(ы)	Описание
   HOST and PORT	Обычно используется порт 8443 при использовании TLS и 8123 без TLS.
   DATABASE NAME	По умолчанию есть база данных default; используйте имя базы данных, к которой хотите подключиться.
   USERNAME and PASSWORD	По умолчанию имя пользователя — default. Используйте имя пользователя, подходящее для вашего сценария использования.

   Сведения о подключении для вашего сервиса ClickHouse Cloud доступны в консоли ClickHouse Cloud. Выберите сервис и нажмите Connect:

   

   Выберите HTTPS. Сведения о подключении будут показаны в примере команды curl.

   

   Если вы используете самоуправляемый ClickHouse, сведения о подключении задаёт ваш администратор ClickHouse.

2. Загрузите и установите Tableau Desktop.

3. Следуйте инструкциям clickhouse-tableau-connector-jdbc, чтобы загрузить совместимую версию JDBC-драйвера ClickHouse.

4. Поместите JDBC-драйвер в следующую папку (в зависимости от вашей ОС; если папки не существует, её можно создать):
   • macOS: ~/Library/Tableau/Drivers
   • Windows: C:\Program Files\Tableau\Drivers
5. Настройте источник данных ClickHouse в Tableau и начните создавать визуализации данных!

Теперь, когда драйвер clickhouse-jdbc установлен и настроен, посмотрим, как создать в Tableau источник данных, подключающийся к базе данных TPCD в ClickHouse.

1. Запустите Tableau. (Если приложение уже запущено, перезапустите его.)

2. В меню слева нажмите More в разделе To a Server. Найдите ClickHouse by ClickHouse в списке доступных коннекторов:

3. Нажмите ClickHouse by ClickHouse, и откроется следующее диалоговое окно:

4. Нажмите Install and Restart Tableau. Перезапустите приложение.
5. После перезапуска коннектор будет отображаться под полным именем: ClickHouse JDBC by ClickHouse, Inc.. При нажатии на него откроется следующее диалоговое окно:

6. Введите сведения о подключении:

   Параметр	Значение
   Server	Хост ClickHouse (без префиксов и суффиксов)
   Port	8443
   Database	default
   Username	default
   Password	******

7. Нажмите кнопку Sign In, и откроется новая рабочая книга Tableau:

8. Выберите TPCD в раскрывающемся списке Schema, и вы увидите список таблиц в TPCD:

Теперь всё готово для создания визуализаций в Tableau!

Теперь, когда источник данных ClickHouse настроен в Tableau, давайте визуализируем данные…

1. Перетащите таблицу CUSTOMER в рабочую книгу. Обратите внимание: столбцы появились, но таблица данных пуста:

2. Нажмите кнопку Update Now, и в таблице появятся 100 строк из CUSTOMER.

3. Перетащите таблицу ORDERS в рабочую книгу, затем укажите Custkey как поле связи между двумя таблицами:

4. Теперь таблицы ORDERS и LINEITEM связаны друг с другом и образуют ваш источник данных, поэтому вы можете использовать эту связь, чтобы отвечать на вопросы по данным. Выберите вкладку Sheet 1 внизу рабочей книги.

5. Предположим, вы хотите узнать, сколько определённых товаров заказывали каждый год. Перетащите OrderDate из ORDERS в раздел Columns (горизонтальное поле), затем перетащите Quantity из LINEITEM в Rows. Tableau построит следующую линейную диаграмму:

Не самая впечатляющая линейная диаграмма, но этот набор данных был сгенерирован скриптом и создан для тестирования производительности запросов, поэтому вы заметите, что в смоделированных заказах данных TCPD не так много вариаций.

6. Предположим, вы хотите узнать среднюю сумму заказа (в долларах) по кварталам, а также по способу доставки (самолёт, почта, корабль, грузовик и т. д.):

   • Нажмите вкладку New Worksheet, чтобы создать новый лист
   • Перетащите OrderDate из ORDERS в Columns и измените значение с Year на Quarter
   • Перетащите Shipmode из LINEITEM в Rows

Вы должны увидеть следующее:

7. Значения Abc просто заполняют пустое место, пока вы не перетащите метрику в таблицу. Перетащите Totalprice из * ORDERS* в таблицу. Обратите внимание, что по умолчанию используется расчёт SUM для Totalprices:

8. Нажмите на SUM и измените Measure на Average. В том же выпадающем меню выберите Format и измените Numbers на Currency (Standard):

Отлично! Вы успешно подключили Tableau к ClickHouse и открыли целый мир возможностей для анализа и визуализации данных ClickHouse.

Если вы используете устаревшую версию Tableau Desktop, в которой коннектор не входит в комплект по умолчанию, вы можете установить его вручную, выполнив следующие шаги:

1. Скачайте последнюю версию файла taco с Tableau Exchange
2. Поместите файл taco в
   • macOS: ~/Documents/My Tableau Repository/Connectors
   • Windows: C:\Users\[Windows User]\Documents\My Tableau Repository\Connectors
3. Перезапустите Tableau Desktop. Если установка прошла успешно, коннектор появится в разделе New Data Source.

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

Коннектор тестируется с помощью фреймворка TDVT; текущий уровень покрытия составляет 97%.

Вы можете подключить Tableau к ClickHouse с помощью универсального драйвера ClickHouse ODBC/JDBC. Однако этот коннектор упрощает процесс настройки подключения. Если у вас возникнут какие-либо проблемы с коннектором, смело сообщайте о них на GitHub.