Skip to main content
Apache Superset es una plataforma de código abierto para la exploración y visualización de datos escrita en Python. Superset se conecta a ClickHouse con un controlador de Python proporcionado por ClickHouse. Veamos cómo funciona…

​
Objetivo

En esta guía crearás un dashboard en Superset con datos de una base de datos de ClickHouse. El dashboard tendrá este aspecto:
Agrega algunos datosSi no tienes un conjunto de datos con el que trabajar, puedes añadir uno de los conjuntos de datos de ejemplo. Esta guía utiliza el conjunto de datos UK Price Paid, así que puedes elegir ese. Hay varios más en la misma categoría de la documentación.
1

Reúne la información de conexión

Para conectarse a ClickHouse con HTTP(S), necesita esta información: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:
Botón Connect del servicio de ClickHouse Cloud
Elija HTTPS. Los detalles de conexión se muestran en un comando curl de ejemplo.
Detalles de conexión HTTPS de ClickHouse Cloud
Si usa ClickHouse autogestionado, los detalles de conexión los establece su administrador de ClickHouse.
2

Instalar el controlador

  1. Superset usa el driver clickhouse-connect para conectarse a ClickHouse. La información sobre clickhouse-connect está disponible en https://pypi.org/project/clickhouse-connect/ y puede instalarse con el siguiente comando:
Configuración de Docker ComposePara instalaciones basadas en Docker, consulta la guía de configuración de la base de datos de Superset para obtener instrucciones sobre cómo añadir clickhouse-connect a tu contenedor.
  1. Inicia (o reinicia) Superset.
3

Conectar Superset con ClickHouse

  1. En Superset, selecciona Data en el menú superior y luego Databases en el menú desplegable. Añade una nueva base de datos haciendo clic en el botón + Database:

  1. En el primer paso, selecciona ClickHouse Connect como tipo de base de datos:

  1. En el segundo paso:
  • Activa o desactiva SSL.
  • Introduce la información de conexión que recopilaste anteriormente
  • Especifica el DISPLAY NAME: puede ser cualquier nombre que prefieras. Si vas a conectarte a varias bases de datos de ClickHouse, haz que el nombre sea más descriptivo.

  1. Haz clic en los botones CONNECT y luego FINISH para completar el asistente de configuración; deberías ver tu base de datos en la lista de bases de datos.
4

Añadir un conjunto de datos

  1. Para interactuar con tus datos de ClickHouse en Superset, necesitas definir un conjunto de datos. En el menú superior de Superset, selecciona Data y luego Datasets en el menú desplegable.
  2. Haz clic en el botón para añadir un conjunto de datos. Selecciona tu nueva base de datos como origen de datos y verás las tablas definidas en ella:

  1. Haz clic en el botón ADD en la parte inferior del cuadro de diálogo y tu tabla aparecerá en la lista de conjuntos de datos. ¡Ya estás listo para crear un dashboard y analizar tus datos de ClickHouse!
5

Creación de gráficos y un dashboard en Superset

Si ya conoces Superset, esta sección te resultará muy familiar. Si no, bueno… es como muchas otras herramientas de visualización: empezar es rápido, pero los detalles y matices se van aprendiendo con el tiempo a medida que usas la herramienta.
  1. Se empieza con un dashboard. En el menú superior de Superset, selecciona Dashboards. Haz clic en el botón de la esquina superior derecha para añadir un nuevo dashboard. El siguiente dashboard se llama UK property prices:

  1. Para crear un nuevo gráfico, selecciona Charts en el menú superior y haz clic en el botón para añadirlo. Verás muchas opciones. El siguiente Example muestra un gráfico Pie Chart usando el conjunto de datos uk_price_paid del desplegable CHOOSE A DATASET:

  1. Los gráficos circulares de Superset necesitan una Dimension y una Metric; el resto de la configuración es opcional. Puedes elegir los campos que quieras para la dimensión y la métrica; en este Example se usa el campo district de ClickHouse como dimensión y AVG(price) como métrica.

  1. Si prefieres los gráficos de dona a los gráficos circulares, puedes configurar esa y otras opciones en CUSTOMIZE:

  1. Haz clic en el botón SAVE para guardar el gráfico; después, selecciona UK property prices en el desplegable ADD TO DASHBOARD. Luego, SAVE & GO TO DASHBOARD guarda el gráfico y lo añade al dashboard:

  1. Eso es todo. Crear dashboards en Superset a partir de datos de ClickHouse abre todo un mundo de analítica de datos ultrarrápida.

Última modificación el 24 de julio de 2026