> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/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 de ClickHouse, diseñada específicamente para aplicaciones de software y SaaS.
# Integración de Luzmo con ClickHouse
export const CommunityMaintainedBadge = () => {
return
Mantenimiento de la comunidad
;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
## 1. Configurar una conexión a ClickHouse
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 complemento 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.
* **Username**: el nombre de usuario que se utilizará para conectarse a su clúster de ClickHouse.
* **Password**: 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.
## 2. Añadir conjuntos de datos
Una vez que hayas conectado ClickHouse, puedes añadir conjuntos de datos como se explica [aquí](https://academy.luzmo.com/article/ldx3iltg). Puedes seleccionar uno o varios conjuntos de datos disponibles en ClickHouse y [vincularlos](https://academy.luzmo.com/article/gkrx48x5) en Luzmo para asegurarte de que puedan usarse juntos en un dashboard. No dejes de consultar también este artículo sobre [Cómo preparar tus datos para el análisis](https://academy.luzmo.com/article/u492qov0).
Para saber cómo añadir conjuntos de datos con nuestra API, consulta [este ejemplo en la documentación para desarrolladores](https://developer.luzmo.com/api/createDataprovider?exampleSection=DataproviderCreateClickhouseRequestBody).
Ahora ya puedes usar tus conjuntos de datos para crear dashboards atractivos (integrados) o incluso impulsar un analista de datos con IA ([Luzmo IQ](https://luzmo.com/iq)) capaz de responder las preguntas de tus 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 |