Saltar al contenido principal

​
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 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í. Puedes seleccionar uno o varios conjuntos de datos disponibles en ClickHouse y vincularlos 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. Para saber cómo añadir conjuntos de datos con nuestra API, consulta este ejemplo en la documentación para desarrolladores. Ahora ya puedes usar tus conjuntos de datos para crear dashboards atractivos (integrados) o incluso impulsar un analista de datos con IA (Luzmo 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. También recomendamos usar un usuario técnico de solo lectura.
  4. Actualmente, el conector ClickHouse admite los siguientes tipos de datos:
Última modificación el 25 de junio de 2026