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

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

Community Maintained

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

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

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

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

Параметр(ы)Описание
HOST и PORTОбычно используется порт 8443 при использовании TLS или 8123 при отсутствии TLS.
DATABASE NAMEПо умолчанию существует база данных default; используйте имя базы данных, к которой вы хотите подключиться.
USERNAME и PASSWORDПо умолчанию имя пользователя — default. Используйте имя пользователя, соответствующее вашему сценарию.

Сведения о вашем сервисе ClickHouse Cloud доступны в консоли ClickHouse Cloud. Выберите сервис и нажмите Connect:

Кнопка подключения сервиса ClickHouse Cloud

Выберите HTTPS. Параметры подключения отображаются в примере команды curl.

Параметры HTTPS-подключения ClickHouse Cloud

Если вы используете самостоятельное (self-managed) развертывание ClickHouse, параметры подключения задаются администратором ClickHouse.

  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, показывающее несколько визуализаций, размещённых в макете дашборда