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

Community Maintained

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

Цель

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

Добавьте немного данных

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

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

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

Параметр(ы)	Описание
HOST and PORT	Typically, the port is 8443 when using TLS or 8123 when not using TLS.
DATABASE NAME	Out of the box, there is a database named default, use the name of the database that you want to connect to.
USERNAME and PASSWORD	Out of the box, the username is default. Use the username appropriate for your use case.

The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select a service and click Connect:

Choose HTTPS. Connection details are displayed in an example curl command.

If you're using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.

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

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

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

   

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

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

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

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

   

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

1. Нажмите кнопку Create dataset или перейдите на вкладку Datasets, чтобы создать его.
2. Выберите подключение к 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;

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

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

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

4. Создайте визуализацию

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

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

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

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

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

Узнать больше

Подробнее читайте в записи блога о Chartbrew и ClickHouse.