> ## 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 es una plataforma de analítica embebida con una integración nativa con ClickHouse, creada específicamente para aplicaciones de software y SaaS.
# Integración de Luzmo con ClickHouse
export const CommunityMaintainedBadge = () => {
return
;
};
Para conectarse a ClickHouse, vaya a la **página Connections**, seleccione **New Connection** y, a continuación, elija ClickHouse en el modal **New Connection**.
Se le pedirá que proporcione un **host**, **nombre de usuario** y **contraseña**:
* **Host**: es el host en el que está expuesta su base de datos de ClickHouse. Tenga en cuenta que aquí solo se permite `https` para transferir datos de forma segura a través de la red. La estructura de la URL del host debe ser: `https://url-to-clickhouse-db:port/database`
De forma predeterminada, el plugin se conectará a la base de datos 'default' y al puerto 443. Si especifica una base de datos después de '/', puede configurar a qué base de datos conectarse.
* **nombre de usuario**: el nombre de usuario que se utilizará para conectarse a su clúster de ClickHouse.
* **contraseña**: la contraseña para conectarse a su clúster de ClickHouse
Consulte los ejemplos de nuestra documentación para desarrolladores para saber cómo [crear una conexión a ClickHouse](https://developer.luzmo.com/api/createAccount?exampleSection=AccountCreateClickhouseRequestBody) a través de nuestra API.
Una vez que haya conectado ClickHouse, puede añadir datasets como se explica [aquí](https://academy.luzmo.com/article/ldx3iltg). Puede seleccionar uno o varios datasets disponibles en ClickHouse y [vincularlos](https://academy.luzmo.com/article/gkrx48x5) en Luzmo para asegurarse de que puedan utilizarse juntos en un dashboard. Asegúrese también de consultar este artículo sobre [Preparar sus datos para la analítica](https://academy.luzmo.com/article/u492qov0).
Para saber cómo añadir datasets usando nuestra API, consulte [este ejemplo en nuestra documentación para desarrolladores](https://developer.luzmo.com/api/createDataprovider?exampleSection=DataproviderCreateClickhouseRequestBody).
Ahora puede usar sus datasets para crear atractivos dashboards (embedded), o incluso potenciar un analista de datos con IA ([Luzmo IQ](https://luzmo.com/iq)) que pueda responder a las preguntas de sus clientes.
## Notas de uso
1. El conector ClickHouse de Luzmo usa la interfaz de la API HTTP (normalmente disponible en el puerto 8123) para conectarse.
2. Si usa tablas con el motor de tablas `Distributed`, algunos gráficos de Luzmo podrían fallar cuando `distributed_product_mode` está establecido en `deny`. No obstante, esto solo debería ocurrir si vincula la tabla con otra tabla y usa ese vínculo en un gráfico. En ese caso, asegúrese de establecer `distributed_product_mode` en otra opción que tenga sentido para su clúster de ClickHouse. Si usa ClickHouse Cloud, puede ignorar esta configuración con seguridad.
3. Para garantizar que, por ejemplo, solo la aplicación de Luzmo pueda acceder a su instancia de ClickHouse, es muy recomendable **incluir en la lista de permitidos** el [rango de direcciones IP estáticas de Luzmo](https://academy.luzmo.com/article/u9on8gbm). También recomendamos usar un usuario técnico de solo lectura.
4. Actualmente, el conector ClickHouse admite los siguientes tipos de datos:
| Tipo de ClickHouse | Tipo de Luzmo |
| ------------------ | ------------- |
| UInt | numeric |
| Int | numeric |
| Float | numeric |
| Decimal | numeric |
| Date | datetime |
| DateTime | datetime |
| String | hierarchy |
| Enum | hierarchy |
| FixedString | hierarchy |
| UUID | hierarchy |
| Bool | hierarchy |