Skip to main content
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 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 a través de nuestra API.
2

Añadir datasets

Una vez que haya conectado ClickHouse, puede añadir datasets como se explica aquí. Puede seleccionar uno o varios datasets disponibles en ClickHouse y vincularlos 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.Para saber cómo añadir datasets usando nuestra API, consulte este ejemplo en nuestra documentación para desarrolladores.Ahora puede usar sus datasets para crear atractivos dashboards (embedded), o incluso potenciar un analista de datos con IA (Luzmo 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. 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 24 de julio de 2026