Коннектор Tableau к ClickHouse от АНАЛИТИКА ПЛЮС

Тот самый, долгожданный коннектор Tableau к ClickHouse от команды АНАЛИТИКА ПЛЮС! Да-да, мы это сделали!

Что это? Расширение для Tableau Desktop / Tableau Server, которое упрощает процесс подключения Tableau к ClickHouse и расширяет поддержку стандартных функций Tableau при работе с ClickHouse (по сравнению с Generic ODBC / JDBC)

Что такое ClickHouse?  Это колоночная аналитическая СУБД с открытым кодом, позволяющая выполнять аналитические запросы в режиме реального времени на структурированных больших данных.

Долгое время пользователи ClickHouse, использующие Tableau для визуализации данных, сталкивались с огромным количеством неудобств из-за того, что в Tableau до сих пор не был доступен стандартный коннектор к Clickhouse — использование LOD’ов, Set’ов, Join’ов в источнике данных и многого другого могло стать причиной появления ошибок в Live режиме, а ведь ради высокой скорости обработки аналитических запросов многие компании выбирали ClickHouse. Теперь это в прошлом — встречайте первый полностью готовый к работе коннектор Tableau к ClickHouse!

Данный коннектор, созданный командой АНАЛИТИКА ПЛЮС, использует оригинальный JDBC драйвер ClickHouse, что позволяет упростить процесс установки драйвера на Tableau Desktop, Tableau Prep Builder и Tableau Server, ведь JDBC драйвер не нужно компилировать под разные платформы (macOS, Windows, Linux), а также в некоторых сценариях JDBC драйвер позволяет получить прирост производительности относительно ODBC драйвера (например, при формировании экстрактов).

 

Коннектор Tableau к ClickHouse от АНАЛИТИКА ПЛЮС.
Что это?

Расширение для Tableau Desktop / Tableau Server, которое упрощает процесс подключения Tableau к ClickHouse и расширяет поддержку стандартных функций Tableau при работе с ClickHouse (по сравнению с Generic ODBC / JDBC)

В релизах нашего репозитория на GitHub вы можете найти файл с расширением .taco — это и есть наш коннектор. Внутри этого файла содержится конфигурация окна подключения к БД, мэппинг функций Tableau на функции Clickhouse, кастомизации для генерации SQL запросов и многое другое.

 

Что такое ClickHouse?

Это колоночная аналитическая СУБД с открытым кодом, позволяющая выполнять аналитические запросы в режиме реального времени на структурированных больших данных, разрабатываемая компанией Яндекс.

 

В чем польза коннектора Tableau к ClickHouse от команды АНАЛИТИКА ПЛЮС?

— По сравнению с другими базами данных (ODBC): этот коннектор использует драйвер JDBC, который в некоторых случаях быстрее, чем драйвер ODBC (например, при создании экстрактов), а также намного проще в установке, чем ODBC (кроссплатформенный файл jar, не требует компиляции для отдельных платформ).

— По сравнению с другими базами данных (JDBC): этот коннектор имеет тонкую настройку SQL-запросов для реализации большинства стандартных функций Tableau (включая несколько JOINS в источнике данных, наборах и так далее) и имеет удобный диалог подключения.

 

Важно: Перед установкой убедитесь, что вы используете Tableau 2020.4+

Процесс установки максимально прост — устанавливаем официальный JDBC драйвер, перемещаем taco файл коннектора в необходимую директорию и запускаем Tableau.

 

Подробная инструкция по установке коннектора для каждого из продуктов (актуальная инструкция всегда доступна в нашем репозитории на GitHub):

 

Как установить коннектор? (Tableau Desktop)

1. Загрузите последнюю версию Clickhouse JDBC Driver (требуется версия 0.3.1 и выше) и поместите его clickhouse-jdbc-***-shaded.jar по адресу:

— macOS: ~/Library/Tableau/Drivers

— Windows: C:\Program Files\Tableau\Drivers

Вам нужно создать папку, если она еще не существует

2. Загрузите последнюю версию clickhouse-jdbc.taco со страницы Releases и разместите ее по адресу:

— macOS: ~/Documents/My Tableau Repository/Connectors

— Windows: C:\Users\[Windows User]\Documents\My Tableau Repository\Connectors

3. Запустите Tableau Desktop

4. В Tableau Desktop: Connect ➔ To a Server ➔ ClickHouse (JDBC) by Analytika Plus

 

Как установить коннектор? (Tableau Prep Builder)

1. Загрузите последнюю версию Clickhouse JDBC Driver (требуется версия 0.3.1 и выше) и поместите его clickhouse-jdbc-***-shaded.jar по адресу:

— macOS: ~/Library/Tableau/Drivers

— Windows: C:\Program Files\Tableau\Drivers

Вам нужно создать папку, если она еще не существует

2. Загрузите последнюю версию clickhouse-jdbc.taco со страницы Releases и разместите ее по адресу:

— macOS: ~/Documents/My Tableau Prep Repository/Connectors

— Windows: C:\Users\[Windows User]\Documents\My Tableau Prep Repository\Connectors

3. Запустите Tableau Prep Builder

4. В Tableau Prep Builder: Connections ➔ + ➔ To a Server ➔ ClickHouse (JDBC) by Analytika Plus

 

Как установить коннектор? (Tableau Server)

1. Загрузите последнюю версию Clickhouse JDBC Driver (требуется версия 0.3.1 и выше) и поместите его clickhouse-jdbc-***-shaded.jar по адресу:

— Linux: /opt/tableau/tableau_driver/jdbc

— Windows: C:\Program Files\Tableau\Drivers

Вам нужно создать папку, если она еще не существует

Для Linux: Убедитесь, что папка доступна для чтения пользователю Tableau. Для этого:

а) Создайте папку: sudo mkdir -p /opt/tableau/tableau_driver/jdbc

б) Скопируйте загруженный файл драйвера в указанное место, заменив [/path/to/file] на путь и [driver file name] на имя загруженного вами драйвера:
sudo cp [/path/to/file/][driver file name].jar /opt/tableau/tableau_driver/jdbc

в) Установите права доступа, чтобы файл был доступен для чтения пользователю “tableau”, заменив [driver file name] на имя загруженного вами драйвера:
sudo chmod 755 /opt/tableau/tableau_driver/jdbc/[driver file name].jar

2. Создайте папку для коннектора. Это должен быть один и тот же путь на каждой машине и на том же диске, на котором установлен сервер.
Например:

— Windows: C:\tableau_connectors

— Linux: /opt/tableau_connectors

3. Загрузите последнюю версию clickhouse-jdbc.taco со страницы Releases и поместите ее в папку, созданную вами на каждой ноде Tableau Server.

4. Настройте опцию native_api.connect_plugins_path в TSM .
Например:

— Windows: tsm configuration set -k native_api.connect_plugins_path -v C:/tableau_connectors

— Linux: tsm configuration set -k native_api.connect_plugins_path -v /opt/tableau_connectors

Если вы получите ошибку конфигурации на этом шаге, попробуйте добавить —force-keys параметр в конец предыдущей команды.

5. Примените изменения конфигурации. Это перезапустит сервер.
tsm pending-changes apply

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

 

Мы надеемся, что этот коннектор позволит вам значительно упростить решение ваших задач по анализу данных, а также воспользоваться максимумом функционала продуктов Tableau Software.