> ## Documentation Index > Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. > Tableau может использовать базы данных и таблицы ClickHouse как источник данных. # Подключение Tableau к ClickHouse export const ClickHouseSupportedBadge = () => { return
Поддерживается в ClickHouse
; }; export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return
{alt}
; }; ClickHouse предлагает официальный коннектор Tableau, доступный на [Tableau Exchange](https://exchange.tableau.com/products/1064). Коннектор основан на современном [JDBC-драйвере](/docs/ru/integrations/language-clients/java/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**: | |
Кнопка подключения сервиса ClickHouse Cloud
Выберите **HTTPS**. Сведения о подключении будут показаны в примере команды `curl`.
Сведения о подключении к ClickHouse Cloud по HTTPS
Если вы используете самоуправляемый ClickHouse, сведения о подключении задаёт ваш администратор ClickHouse. 2. Загрузите и установите Tableau Desktop. 3. Следуйте инструкциям `clickhouse-tableau-connector-jdbc`, чтобы загрузить совместимую версию JDBC-драйвера ClickHouse. Убедитесь, что загружаете JAR-файл [clickhouse-jdbc-X.X.X-all-dependencies.jar](https://github.com/ClickHouse/clickhouse-java/releases). Этот файл доступен начиная с версии `0.9.2`. 4. Поместите JDBC-драйвер в следующую папку (в зависимости от вашей ОС; если папки не существует, её можно создать): * macOS: `~/Library/Tableau/Drivers` * Windows: `C:\Program Files\Tableau\Drivers` 5. Настройте источник данных ClickHouse в Tableau и начните создавать визуализации данных!
## Настройка источника данных ClickHouse в Tableau
Теперь, когда драйвер `clickhouse-jdbc` установлен и настроен, посмотрим, как создать в Tableau источник данных, подключающийся к базе данных **TPCD** в ClickHouse. 1. Запустите Tableau. (Если приложение уже запущено, перезапустите его.) 2. В меню слева нажмите **More** в разделе **To a Server**. Найдите **ClickHouse by ClickHouse** в списке доступных коннекторов: Экран подключения Tableau, показывающий меню выбора коннектора с выделенным вариантом ClickHouse by ClickHouse
Не видите коннектор **ClickHouse by ClickHouse** в списке коннекторов? Это может быть связано с устаревшей версией Tableau Desktop. Чтобы решить проблему, обновите Tableau Desktop или [установите коннектор вручную](#install-the-connector-manually). 3. Нажмите **ClickHouse by ClickHouse**, и откроется следующее диалоговое окно: Диалог установки коннектора Tableau, показывающий сведения о коннекторе ClickHouse JDBC и кнопку установки
4. Нажмите **Install and Restart Tableau**. Перезапустите приложение. 5. После перезапуска коннектор будет отображаться под полным именем: `ClickHouse JDBC by ClickHouse, Inc.`. При нажатии на него откроется следующее диалоговое окно: Диалог подключения ClickHouse в Tableau с полями server, port, database, username и password
6. Введите сведения о подключении: | Параметр | Значение | | -------- | ----------------------------------------------- | | Server | **Хост ClickHouse (без префиксов и суффиксов)** | | Port | **8443** | | Database | **default** | | Username | **default** | | Password | \*\*\*\*\*\* | При работе с ClickHouse Cloud для защищённых подключений необходимо установить флажок SSL.
Наша база данных ClickHouse называется **TPCD**, но в диалоговом окне выше для **Database** нужно указать **default**, а затем на следующем шаге выбрать **TPCD** в поле **Schema**. (Вероятно, это связано с ошибкой в коннекторе, поэтому такое поведение может измениться, но пока в качестве базы данных нужно использовать **default**.) 7. Нажмите кнопку **Sign In**, и откроется новая рабочая книга Tableau: Новая рабочая книга Tableau, показывающая начальный экран подключения с вариантами выбора базы данных
8. Выберите **TPCD** в раскрывающемся списке **Schema**, и вы увидите список таблиц в **TPCD**: Выбор схемы в Tableau, показывающий таблицы базы данных TPCD, включая CUSTOMER, LINEITEM, NATION, ORDERS и другие
Теперь всё готово для создания визуализаций в Tableau!
## Создание визуализаций в Tableau
Теперь, когда источник данных ClickHouse настроен в Tableau, давайте визуализируем данные... 1. Перетащите таблицу **CUSTOMER** в рабочую книгу. Обратите внимание: столбцы появились, но таблица данных пуста: Рабочая книга Tableau с таблицей CUSTOMER, перетащенной на холст: видны заголовки столбцов, но данных нет
2. Нажмите кнопку **Update Now**, и в таблице появятся 100 строк из **CUSTOMER**. 3. Перетащите таблицу **ORDERS** в рабочую книгу, затем укажите **Custkey** как поле связи между двумя таблицами: Редактор связей Tableau, показывающий связь между таблицами CUSTOMER и ORDERS по полю Custkey
4. Теперь таблицы **ORDERS** и **LINEITEM** связаны друг с другом и образуют ваш источник данных, поэтому вы можете использовать эту связь, чтобы отвечать на вопросы по данным. Выберите вкладку **Sheet 1** внизу рабочей книги. Лист Tableau, показывающий Dimensions и Measures из таблиц ClickHouse, доступные для анализа
5. Предположим, вы хотите узнать, сколько определённых товаров заказывали каждый год. Перетащите **OrderDate** из **ORDERS** в раздел **Columns** (горизонтальное поле), затем перетащите **Quantity** из **LINEITEM** в **Rows**. Tableau построит следующую линейную диаграмму: Линейная диаграмма Tableau, показывающая количество заказанных товаров по годам на основе данных ClickHouse
Не самая впечатляющая линейная диаграмма, но этот набор данных был сгенерирован скриптом и создан для тестирования производительности запросов, поэтому вы заметите, что в смоделированных заказах данных TCPD не так много вариаций. 6. Предположим, вы хотите узнать среднюю сумму заказа (в долларах) по кварталам, а также по способу доставки (самолёт, почта, корабль, грузовик и т. д.): * Нажмите вкладку **New Worksheet**, чтобы создать новый лист * Перетащите **OrderDate** из **ORDERS** в **Columns** и измените значение с **Year** на **Quarter** * Перетащите **Shipmode** из **LINEITEM** в **Rows** Вы должны увидеть следующее: Перекрёстная таблица Tableau с кварталами в столбцах и способами доставки в строках
7. Значения **Abc** просто заполняют пустое место, пока вы не перетащите метрику в таблицу. Перетащите **Totalprice** из \* *ORDERS*\* в таблицу. Обратите внимание, что по умолчанию используется расчёт **SUM** для **Totalprices**: Перекрёстная таблица Tableau, показывающая сумму общей стоимости по кварталам и способам доставки
8. Нажмите на **SUM** и измените **Measure** на **Average**. В том же выпадающем меню выберите **Format** и измените **Numbers** на **Currency (Standard)**: Перекрёстная таблица Tableau, показывающая среднюю стоимость заказа по кварталам и способам доставки с валютным форматированием
Отлично! Вы успешно подключили Tableau к ClickHouse и открыли целый мир возможностей для анализа и визуализации данных ClickHouse.
## Установите коннектор вручную
Если вы используете устаревшую версию Tableau Desktop, в которой коннектор не входит в комплект по умолчанию, вы можете установить его вручную, выполнив следующие шаги: 1. Скачайте последнюю версию файла taco с [Tableau Exchange](https://exchange.tableau.com/products/1064) 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, посетите страницы [Советы по подключению](/docs/ru/integrations/connectors/data-visualization/tableau/tableau-connection-tips) и [Советы по анализу](/docs/ru/integrations/connectors/data-visualization/tableau/tableau-analysis-tips).
## Тесты
Коннектор тестируется с помощью [фреймворка TDVT](https://tableau.github.io/connector-plugin-sdk/docs/tdvt); текущий уровень покрытия составляет 97%.
## Краткое описание
Вы можете подключить Tableau к ClickHouse с помощью универсального драйвера ClickHouse ODBC/JDBC. Однако этот коннектор упрощает процесс настройки подключения. Если у вас возникнут какие-либо проблемы с коннектором, смело сообщайте о них на GitHub.