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

Подключение Zing Data к ClickHouse

Community Maintained

Zing Data — это платформа для исследования и визуализации данных. Zing Data подключается к ClickHouse с помощью JS-драйвера, предоставляемого ClickHouse.

Как подключиться

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

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

Parameter(s)Description
HOST and PORTTypically, the port is 8443 when using TLS or 8123 when not using TLS.
DATABASE NAMEOut of the box, there is a database named default, use the name of the database that you want to connect to.
USERNAME and PASSWORDOut 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:

ClickHouse Cloud service connect button

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

ClickHouse Cloud HTTPS connection details

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

  1. Скачайте или откройте Zing Data

    • Чтобы использовать ClickHouse с Zing Data на мобильном устройстве, скачайте приложение Zing Data в Google Play Store или Apple App Store.

    • Чтобы использовать ClickHouse с Zing Data в веб-интерфейсе, откройте веб-консоль Zing и создайте учетную запись.

  2. Добавьте источник данных

    • Чтобы работать с данными ClickHouse в Zing Data, необходимо определить источник данных. В меню мобильного приложения Zing Data выберите Sources, затем нажмите Add a Datasource.

    • Чтобы добавить источник данных в веб-интерфейсе, нажмите Data Sources в верхнем меню, затем нажмите New Datasource и выберите ClickHouse в раскрывающемся меню.

    Интерфейс Zing Data с кнопкой New Datasource и вариантом ClickHouse в раскрывающемся меню

  3. Заполните сведения для подключения и нажмите Check Connection.

    Форма настройки подключения к ClickHouse в Zing Data с полями для сервера, порта, базы данных, имени пользователя и пароля

  4. Если подключение выполнено успешно, Zing перейдет к выбору таблиц. Выберите нужные таблицы и нажмите Save. Если Zing не может подключиться к вашему источнику данных, вы увидите сообщение с просьбой проверить учетные данные и повторить попытку. Если даже после проверки учетных данных и повторной попытки проблема сохраняется, свяжитесь со службой поддержки Zing.

    Интерфейс выбора таблиц Zing Data, показывающий доступные таблицы ClickHouse с флажками

  5. После того как источник данных ClickHouse добавлен, он будет доступен всем пользователям в вашей организации Zing на вкладке Data Sources / Sources.

Создание графиков и дашбордов в Zing Data

  1. После добавления источника данных ClickHouse нажмите Zing App в веб-интерфейсе или выберите источник данных в мобильном приложении, чтобы начать создавать графики.

  2. Выберите таблицу в списке таблиц, чтобы создать график.

    Интерфейс Zing Data, показывающий список таблиц с доступными таблицами ClickHouse

  3. Используйте визуальный конструктор запросов, чтобы выбрать нужные поля, агрегации и т. д., и нажмите Run Question.

    Интерфейс визуального конструктора запросов Zing Data с выбором полей и параметрами агрегации

  4. Если вы знакомы с SQL, вы также можете написать произвольный SQL‑запрос, выполнить его и на его основе построить график.

    Режим SQL‑редактора в Zing Data, показывающий интерфейс для написания SQL‑запросов
    Результаты SQL‑запроса в Zing Data с данными, отображёнными в табличном формате
  5. Пример графика может выглядеть следующим образом. Запрос (Question) можно сохранить через меню с тремя точками. Вы можете комментировать график, отмечать участников команды, создавать оповещения в реальном времени, менять тип графика и т. д.

    Пример визуализации графика в Zing Data, показывающий данные из ClickHouse с меню параметров

  6. Дашборды можно создавать с помощью значка «+» в разделе Dashboards на главном экране. Существующие запросы можно перетащить, чтобы отобразить их на дашборде.

    Представление дашборда Zing Data, показывающее несколько визуализаций, размещённых в макете дашборда