Conectar Chartbrew con ClickHouse

Conecta Chartbrew con ClickHouse para crear dashboards en tiempo real e informes para clientes.

Chartbrew es una plataforma de visualización de datos que te permite crear dashboards y supervisar los datos en tiempo real. Admite múltiples fuentes de datos, entre ellas ClickHouse, y ofrece una interfaz sin código para crear gráficos e informes.

​

Objetivo

En esta guía, conectarás Chartbrew a ClickHouse, ejecutarás una consulta SQL y crearás una visualización. Al final, tu dashboard podría verse así:

Agrega algunos datos

Si no tienes un conjunto de datos con el que trabajar, puedes agregar uno de los conjuntos de datos de ejemplo. Esta guía utiliza el conjunto de datos UK Price Paid.

​

1. Reúne los datos de conexión

Para conectarse a ClickHouse con HTTP(S), necesita esta información:

Parámetro(s)	Descripción
HOST and PORT	Normalmente, el puerto es 8443 cuando se usa TLS o 8123 cuando no se usa TLS.
DATABASE NAME	De forma predeterminada, existe una base de datos llamada default; use el nombre de la base de datos a la que desea conectarse.
USERNAME and PASSWORD	De forma predeterminada, el nombre de usuario es default. Use el nombre de usuario adecuado para su caso de uso.

Los detalles de su servicio de ClickHouse Cloud están disponibles en la consola de ClickHouse Cloud. Seleccione un servicio y haga clic en Connect:

Elija HTTPS. Los detalles de conexión se muestran en un comando curl de ejemplo.

Si usa ClickHouse autogestionado, los detalles de conexión los establece su administrador de ClickHouse.

​

2. Conecta Chartbrew a ClickHouse

1. Inicia sesión en Chartbrew y ve a la pestaña Connections.

2. Haz clic en Create connection y selecciona ClickHouse entre las opciones de bases de datos disponibles.

3. Introduce los datos de conexión de tu base de datos de ClickHouse:

   • Display Name: Un nombre para identificar la conexión en Chartbrew.
   • Host: El hostname o la dirección IP de tu servidor de ClickHouse.
   • Port: Normalmente, 8443 para conexiones HTTPS.
   • Database Name: La base de datos a la que quieres conectarte.
   • Username: Tu nombre de usuario de ClickHouse.
   • Password: Tu contraseña de ClickHouse.

4. Haz clic en Test connection para comprobar que Chartbrew puede conectarse a ClickHouse.

5. Si la prueba se realiza correctamente, haz clic en Save connection. Chartbrew recuperará automáticamente el esquema desde ClickHouse.

​

3. Crear un conjunto de datos y ejecutar una consulta SQL

1. Haz clic en el botón Crear conjunto de datos o ve a la pestaña Conjuntos de datos para crear uno.
2. Selecciona la conexión de ClickHouse que creaste antes.

Escribe una consulta SQL para obtener los datos que quieras visualizar. Por ejemplo, esta consulta calcula el precio medio pagado por año a partir del conjunto de datos uk_price_paid:

  SELECT toYear(date) AS year, avg(price) AS avg_price
  FROM uk_price_paid
  GROUP BY year
  ORDER BY year;

Haz clic en Run query para obtener los datos.

Si no estás seguro de cómo escribir la consulta, puedes usar el asistente de IA de Chartbrew para generar consultas SQL basadas en el esquema de tu base de datos.

Una vez obtenidos los datos, haz clic en Configure conjunto de datos para configurar los parámetros de la visualización.

​

4. Crear una visualización

1. Defina una métrica (valor numérico) y una dimensión (valor categórico) para su visualización.
2. Obtenga una vista previa del conjunto de datos para asegurarse de que los resultados de la consulta tengan la estructura correcta.
3. Elija un tipo de gráfico (p. ej., gráfico de líneas, gráfico de barras o gráfico circular) y añádalo a su dashboard.
4. Haga clic en Complete conjunto de datos para finalizar la configuración.

Puede crear tantos conjuntos de datos como desee para visualizar distintos aspectos de sus datos. Con estos conjuntos de datos, puede crear varios dashboards para realizar un seguimiento de diferentes métricas.

​

5. Automatiza las actualizaciones de datos

Para mantener tu dashboard actualizado, puedes programar actualizaciones automáticas de datos:

1. Haz clic en el icono del calendario junto al botón de actualización del conjunto de datos.
2. Configura el intervalo de actualización (p. ej., cada hora o cada día).
3. Guarda la configuración para habilitar la actualización automática.

​

Más información

Para obtener más información, consulta la entrada del blog sobre Chartbrew y ClickHouse.