Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Интеграция Luzmo с ClickHouse

Поддерживается сообществом

Настройка подключения к ClickHouse

Чтобы подключиться к ClickHouse, перейдите на страницу Connections, выберите New Connection, затем выберите ClickHouse в модальном окне New Connection.

Интерфейс Luzmo с диалоговым окном Create a New Connection, в котором выбран ClickHouse

Вам будет предложено указать host, username и password:

Форма настройки подключения Luzmo с полями host, username и password для ClickHouse
  • Host: хост, на котором доступна ваша база данных ClickHouse. Обратите внимание, что здесь допускается только https, чтобы безопасно передавать данные по сети. URL хоста должен иметь следующую структуру: https://url-to-clickhouse-db:port/database По умолчанию плагин подключается к базе данных default через порт 443. Если указать базу данных после символа /, можно настроить, к какой базе данных выполнять подключение.
  • Username: имя пользователя, которое будет использоваться для подключения к вашему кластеру ClickHouse.
  • Password: пароль для подключения к вашему кластеру ClickHouse

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

Добавление датасетов

После подключения к ClickHouse вы можете добавить датасеты, как описано здесь. Вы можете выбрать один или несколько датасетов, доступных в ClickHouse, и связать их в Luzmo, чтобы использовать вместе на панели мониторинга. Также рекомендуем ознакомиться с этой статьёй о подготовке данных для аналитики.

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

Теперь вы можете использовать свои датасеты для создания красивых встраиваемых панелей мониторинга или даже для работы ИИ-аналитика данных (Luzmo IQ), который может отвечать на вопросы ваших клиентов.

Пример панели мониторинга Luzmo с несколькими визуализациями данных из ClickHouse

Примечания по использованию

  1. Коннектор Luzmo ClickHouse использует интерфейс HTTP API (обычно доступный на порту 8123) для подключения.

  2. Если вы используете таблицы с движком таблицы Distributed, некоторые диаграммы Luzmo могут не работать, когда distributed_product_mode установлено в deny. Однако это происходит только в том случае, если вы связываете таблицу с другой таблицей и используете эту связь в диаграмме. В таком случае установите для distributed_product_mode другое значение, подходящее для вашего кластера ClickHouse. Если вы используете ClickHouse Cloud, этот параметр можно спокойно игнорировать.

  3. Чтобы доступ к вашему экземпляру ClickHouse имело, например, только приложение Luzmo, настоятельно рекомендуется внести в белый список диапазон статических IP-адресов Luzmo. Мы также рекомендуем использовать техническую учетную запись только для чтения.

  4. В настоящее время коннектор ClickHouse поддерживает следующие типы данных:

    Тип ClickHouse Тип Luzmo
    UInt numeric
    Int numeric
    Float numeric
    Decimal numeric
    Date datetime
    DateTime datetime
    String hierarchy
    Enum hierarchy
    FixedString hierarchy
    UUID hierarchy
    Bool hierarchy
Navigation