Интеграция 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, обратитесь к этому примеру в документации для разработчиков.

Теперь вы можете использовать свои наборы данных для создания красивых (встраиваемых) дашбордов или даже для работы ИИ-аналитика данных (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	Тип Luzmo
   UInt	numeric
   Int	numeric
   Float	numeric
   Decimal	numeric
   Date	datetime
   DateTime	datetime
   String	hierarchy
   Enum	hierarchy
   FixedString	hierarchy
   UUID	hierarchy
   Bool	hierarchy