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

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

Community Maintained

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

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

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

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

Параметр(ы)Описание
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're 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. Пример графика будет выглядеть следующим образом. Запрос можно сохранить с помощью меню с тремя точками. Вы можете комментировать график, отмечать участников команды, создавать оповещения в реальном времени, изменять тип графика и т.д.

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

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

    Представление дашборда Zing Data с несколькими визуализациями, расположенными в макете дашборда