Перейти к основному содержанию
Перейти к основному содержанию

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

Community Maintained

Chartbrew — это платформа визуализации данных, которая позволяет пользователям создавать дашборды и мониторить данные в режиме реального времени. Она поддерживает различные источники данных, включая ClickHouse, и предоставляет интерфейс без необходимости писать код для создания графиков и отчётов.

Цель​

В этом руководстве вы подключите Chartbrew к ClickHouse, выполните SQL-запрос и создадите визуализацию. В конце ваша панель мониторинга может выглядеть примерно так:

Панель мониторинга Chartbrew
Добавьте данные

Если у вас нет набора данных для работы, вы можете добавить один из примеров. В этом руководстве используется набор данных UK Price Paid.

1. Соберите параметры подключения​

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

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

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

Кнопка подключения сервиса ClickHouse Cloud

Выберите HTTPS. Параметры подключения отображаются в примере команды curl.

Параметры HTTPS-подключения ClickHouse Cloud

Если вы используете самостоятельное (self-managed) развертывание ClickHouse, параметры подключения задаются администратором ClickHouse.

2. Подключение Chartbrew к ClickHouse​

  1. Войдите в Chartbrew и перейдите на вкладку Connections.

  2. Нажмите Create connection и выберите ClickHouse из доступных вариантов баз данных.

    Выбор подключения ClickHouse в Chartbrew

  3. Введите параметры подключения к вашей базе данных ClickHouse:

    • Display Name: Отображаемое имя подключения в Chartbrew.
    • Host: Имя хоста или IP-адрес сервера ClickHouse.
    • Port: Обычно 8443 для HTTPS-подключения.
    • Database Name: База данных, к которой вы хотите подключиться.
    • Username: Имя пользователя ClickHouse.
    • Password: Пароль пользователя ClickHouse.
    Настройки подключения ClickHouse в Chartbrew

  4. Нажмите Test connection, чтобы убедиться, что Chartbrew может подключиться к ClickHouse.

  5. Если проверка прошла успешно, нажмите Save connection. Chartbrew автоматически получит схему базы данных из ClickHouse.

    JSON-схема ClickHouse в Chartbrew

3. Создайте набор данных и выполните SQL-запрос​

  1. Нажмите кнопку Create dataset или перейдите на вкладку Datasets, чтобы создать набор данных.
  2. Выберите подключение к ClickHouse, созданное ранее.
Выбор подключения ClickHouse для набора данных

Напишите SQL-запрос для получения данных, которые вы хотите визуализировать. Например, этот запрос вычисляет среднюю уплаченную цену по годам из набора данных uk_price_paid:

SELECT toYear(date) AS year, avg(price) AS avg_price
FROM uk_price_paid
GROUP BY year
ORDER BY year;
SQL-запрос ClickHouse в Chartbrew

Нажмите Run query, чтобы выполнить запрос и получить данные.

Если вы не уверены, как составить запрос, вы можете использовать AI-помощник Chartbrew для генерации SQL-запросов на основе схемы вашей базы данных.

AI-помощник по SQL для ClickHouse в Chartbrew

После того как данные будут получены, нажмите Configure dataset, чтобы настроить параметры визуализации.

4. Создание визуализации​

  1. Определите метрику (числовое значение) и размерность (категориальное значение) для визуализации.
  2. Просмотрите набор данных в режиме предварительного просмотра, чтобы убедиться, что результаты запроса корректно структурированы.
  3. Выберите тип диаграммы (например, линейную, столбчатую или круговую диаграмму) и добавьте её на дашборд.
  4. Нажмите Complete dataset, чтобы завершить настройку.
Дашборд Chartbrew с данными ClickHouse

Вы можете создавать столько наборов данных, сколько потребуется, чтобы визуализировать разные аспекты ваших данных. Используя эти наборы данных, вы можете создавать несколько дашбордов для отслеживания различных метрик.

Дашборд Chartbrew с данными ClickHouse

5. Автоматизация обновления данных​

Чтобы панель мониторинга всегда отображала актуальные данные, вы можете запланировать автоматическое обновление:

  1. Нажмите на значок календаря рядом с кнопкой обновления набора данных.
  2. Настройте интервал обновления (например, каждый час или каждый день).
  3. Сохраните настройки, чтобы включить автоматическое обновление.
Настройки обновления набора данных в Chartbrew

Дополнительные материалы​

Более подробную информацию можно найти в статье в блоге о Chartbrew и ClickHouse.