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

Community Maintained

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

Цель

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

Добавьте данные

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

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

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

• ХОСТ и ПОРТ: как правило, порт 8443 при использовании TLS или 8123 при отсутствии TLS.

• ИМЯ БАЗЫ ДАННЫХ: по умолчанию существует база данных с именем default, используйте имя базы данных, к которой вы хотите подключиться.

• ИМЯ ПОЛЬЗОВАТЕЛЯ и ПАРОЛЬ: по умолчанию имя пользователя default. Используйте имя пользователя, подходящее для вашего случая.

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

Выберите HTTPS, и данные будут доступны в примере команды curl.

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

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.