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

Подключите Superset к ClickHouse

Community Maintained

Apache Superset - это платформа для исследования и визуализации данных с открытым исходным кодом, написанная на Python. Superset подключается к ClickHouse с помощью Python-драйвера, предоставленного ClickHouse. Давайте посмотрим, как это работает...

Цель​

В этом руководстве вы создадите дашборд в Superset с данными из базы данных ClickHouse. Дашборд будет выглядеть так:


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

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

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

To connect to ClickHouse with HTTP(S) you need this information:

  • The HOST and PORT: typically, the port is 8443 when using TLS or 8123 when not using TLS.

  • The DATABASE NAME: out of the box, there is a database named default, use the name of the database that you want to connect to.

  • The 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 the service that you will connect to and click Connect:

Choose HTTPS, and the details are available in an example curl command.

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

2. Установите драйвер​

  1. Superset использует драйвер clickhouse-connect для подключения к ClickHouse. Подробности о clickhouse-connect можно найти по адресу https://pypi.org/project/clickhouse-connect/, его можно установить с помощью следующей команды:

  2. Запустите (или перезапустите) Superset.

3. Подключите Superset к ClickHouse​

  1. В Superset выберите Data в верхнем меню, затем Databases в выпадающем меню. Добавьте новую базу данных, нажав кнопку + Database:

  1. На первом шаге выберите ClickHouse Connect в качестве типа базы данных:

  1. На втором шаге:
  • Установите SSL вкл. или выкл.
  • Введите информацию о подключении, которую вы собрали ранее.
  • Укажите DISPLAY NAME: это может быть любое имя на ваш выбор. Если вы будете подключаться к нескольким базам данных ClickHouse, сделайте имя более описательным.

  1. Нажмите кнопки CONNECT, а затем FINISH, чтобы завершить мастер настройки, и вы должны увидеть вашу базу данных в списке баз данных.

4. Добавьте набор данных​

  1. Чтобы взаимодействовать с данными ClickHouse в Superset, вам нужно определить набор данных. В верхнем меню Superset выберите Data, затем Datasets из выпадающего меню.

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


  1. Нажмите кнопку ADD в нижней части диалогового окна, и ваша таблица появится в списке наборов данных. Теперь вы готовы создать дашборд и проанализировать ваши данные ClickHouse!

5. Создание диаграмм и дашборда в Superset​

Если вы знакомы с Superset, то в этом следующем разделе будете чувствовать себя как дома. Если вы новичок в Superset, ну...это как и большинство других классных инструментов визуализации - не займет много времени, чтобы начать, но детали и нюансы будут усваиваемы со временем, когда вы будете использовать инструмент.

  1. Вы начинаете с дашборда. В верхнем меню Superset выберите Dashboards. Нажмите кнопку в правом верхнем углу, чтобы добавить новый дашборд. Следующий дашборд называется Цены на недвижимость в Великобритании:

  1. Чтобы создать новую диаграмму, выберите Charts в верхнем меню и нажмите кнопку для добавления новой диаграммы. Вам будет представлено много вариантов. В следующем примере показана Круговая диаграмма с использованием набора данных uk_price_paid из выпадающего меню CHOOSE A DATASET:

  1. Круговые диаграммы Superset требуют Dimension и Metric, остальные параметры являются необязательными. Вы можете выбрать свои собственные поля для измерения и метрики, в этом примере используется поле ClickHouse district в качестве измерения и AVG(price) в качестве метрики.

  1. Если вам больше нравятся донатные диаграммы, то вы можете установить это и другие параметры в разделе CUSTOMIZE:

  1. Нажмите кнопку SAVE, чтобы сохранить диаграмму, затем выберите Цены на недвижимость в Великобритании в выпадающем меню ADD TO DASHBOARD, затем SAVE & GO TO DASHBOARD, чтобы сохранить диаграмму и добавить ее на дашборд:

  1. Вот и всё. Создание дашбордов в Superset на основе данных в ClickHouse открывает целый мир стремительной аналитики данных!

Связанный контент​