> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> Luzmo — это платформа встроенной аналитики с нативной интеграцией с ClickHouse, разработанная специально для программных и SaaS-приложений.
# Интеграция Luzmo с ClickHouse
export const CommunityMaintainedBadge = () => {
return
Поддерживается сообществом
;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
Чтобы подключиться к 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](https://developer.luzmo.com/api/createAccount?exampleSection=AccountCreateClickhouseRequestBody) через наш API.
После подключения к ClickHouse вы можете добавить датасеты, как описано [здесь](https://academy.luzmo.com/article/ldx3iltg). Вы можете выбрать один или несколько датасетов, доступных в ClickHouse, и [связать](https://academy.luzmo.com/article/gkrx48x5) их в Luzmo, чтобы использовать вместе на панели мониторинга. Также рекомендуем ознакомиться с этой статьёй о [подготовке данных для аналитики](https://academy.luzmo.com/article/u492qov0).
Чтобы узнать, как добавлять датасеты с помощью нашего API, обратитесь к [этому примеру в нашей документации для разработчиков](https://developer.luzmo.com/api/createDataprovider?exampleSection=DataproviderCreateClickhouseRequestBody).
Теперь вы можете использовать свои датасеты для создания красивых встраиваемых панелей мониторинга или даже для работы ИИ-аналитика данных ([Luzmo IQ](https://luzmo.com/iq)), который может отвечать на вопросы ваших клиентов.
## Примечания по использованию
1. Коннектор Luzmo ClickHouse использует интерфейс HTTP API (обычно доступный на порту 8123) для подключения.
2. Если вы используете таблицы с движком таблицы `Distributed`, некоторые диаграммы Luzmo могут не работать, когда `distributed_product_mode` установлено в `deny`. Однако это происходит только в том случае, если вы связываете таблицу с другой таблицей и используете эту связь в диаграмме. В таком случае установите для `distributed_product_mode` другое значение, подходящее для вашего кластера ClickHouse. Если вы используете ClickHouse Cloud, этот параметр можно спокойно игнорировать.
3. Чтобы доступ к вашему экземпляру ClickHouse имело, например, только приложение Luzmo, настоятельно рекомендуется **внести в белый список** [диапазон статических IP-адресов Luzmo](https://academy.luzmo.com/article/u9on8gbm). Мы также рекомендуем использовать техническую учетную запись только для чтения.
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 |