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

Community Maintained

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   ClickHouse Type	Luzmo Type
   UInt	numeric
   Int	numeric
   Float	numeric
   Decimal	numeric
   Date	datetime
   DateTime	datetime
   String	hierarchy
   Enum	hierarchy
   FixedString	hierarchy
   UUID	hierarchy
   Bool	hierarchy