Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Conectar Superset con ClickHouse

View as MarkdownEdit this pageReport an issueSet up docs MCP
Compatible con ClickHouse

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:

Dashboard de Superset que muestra precios de propiedades del Reino Unido con múltiples visualizaciones, incluidos gráficos circulares y tablas

Reúne la información 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:

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.

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:

    pip install clickhouse-connect
  1. Inicia (o reinicia) Superset.

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:
Interfaz de Superset que muestra el menú Database con el botón + Database resaltado

  1. En el primer paso, selecciona ClickHouse Connect como tipo de base de datos:
Asistente de conexión de base de datos de Superset con la opción ClickHouse Connect seleccionada

  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.
Formulario de configuración de conexión de Superset que muestra los parámetros de la conexión de ClickHouse

  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.

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:

Cuadro de diálogo de creación de conjunto de datos en Superset que muestra las tablas disponibles de la base de datos ClickHouse

  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!

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:
Dashboard vacío de Superset llamado UK property prices, listo para añadir gráficos

  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:
Interfaz de creación de gráficos de Superset con el tipo de visualización Pie Chart seleccionado

  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.
Configuración de Dimension con el campo district seleccionado para el gráfico circular
Configuración de Metric con la aggregate function AVG(price) para el gráfico circular

  1. Si prefieres los gráficos de dona a los gráficos circulares, puedes configurar esa y otras opciones en CUSTOMIZE:
Panel CUSTOMIZE con la opción de gráfico de dona y otros ajustes de configuración del gráfico circular

  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:
Cuadro de diálogo para guardar el gráfico con desplegable de selección de dashboard y botón Save & Go to 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.
Dashboard de Superset completado con varias visualizaciones de datos de precios inmobiliarios del Reino Unido desde ClickHouse

Navigation