Saltar al contenido principal
ClickHouse ofrece un conector oficial para Tableau, disponible en el Tableau Exchange. El conector se basa en el avanzado JDBC driver de ClickHouse. Con este conector, Tableau integra las bases de datos y tablas de ClickHouse como orígenes de datos. Para habilitar esta funcionalidad, siga la guía de configuración que aparece a continuación.

​
Configuración necesaria antes de su uso

  1. Reúne tus datos de conexión Para conectarse a ClickHouse con HTTP(S), necesita esta información:
    Parámetro(s)Descripción
    HOST and PORTNormalmente, el puerto es 8443 cuando se usa TLS o 8123 cuando no se usa TLS.
    DATABASE NAMEDe forma predeterminada, existe una base de datos llamada default; use el nombre de la base de datos a la que desea conectarse.
    USERNAME and PASSWORDDe 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. Descarga e instala Tableau Desktop.
  3. Sigue las instrucciones de clickhouse-tableau-connector-jdbc para descargar la versión compatible del ClickHouse JDBC driver.
Asegúrate de descargar el archivo JAR clickhouse-jdbc-X.X.X-all-dependencies.jar. Este artefacto está disponible a partir de la versión 0.9.2.
  1. Guarda el JDBC driver en la siguiente carpeta (según tu sistema operativo; si la carpeta no existe, puedes crearla):
    • macOS: ~/Library/Tableau/Drivers
    • Windows: C:\Program Files\Tableau\Drivers
  2. Configura un origen de datos de ClickHouse en Tableau y empieza a crear visualizaciones.

​
Configurar un origen de datos de ClickHouse en Tableau

Ahora que tienes el driver clickhouse-jdbc instalado y configurado, veamos cómo definir un origen de datos en Tableau que se conecte a la base de datos TPCD de ClickHouse.
  1. Inicia Tableau. (Si ya estaba en ejecución, reinícialo).
  2. En el menú de la izquierda, haz clic en More en la sección To a Server. Busca ClickHouse by ClickHouse en la lista de conectores disponibles:

¿No ves el conector ClickHouse by ClickHouse en la lista de conectores? Podría deberse a una versión antigua de Tableau Desktop. Para solucionarlo, considera actualizar la aplicación Tableau Desktop o instalar el conector manualmente.
  1. Haz clic en ClickHouse by ClickHouse y aparecerá el siguiente cuadro de diálogo:

  1. Haz clic en Install and Restart Tableau. Reinicia la aplicación.
  2. Después de reiniciar, el conector tendrá su nombre completo: ClickHouse JDBC by ClickHouse, Inc.. Al hacer clic en él, aparecerá el siguiente cuadro de diálogo:

  1. Introduce los datos de conexión:
    SettingValue
    ServerTu host de ClickHouse (sin prefijos ni sufijos)
    Port8443
    Databasedefault
    Usernamedefault
    Password******
Si trabajas con ClickHouse Cloud, debes activar la casilla SSL para usar conexiones seguras.

Nuestra base de datos de ClickHouse se llama TPCD, pero debes establecer Database en default en el cuadro de diálogo anterior y luego seleccionar TPCD en Schema en el siguiente paso. (Probablemente se deba a un error del conector, por lo que este comportamiento podría cambiar, pero por ahora debes usar default como base de datos).
  1. Haz clic en el botón Sign In y deberías ver un nuevo libro de trabajo de Tableau:

  1. Selecciona TPCD en el desplegable Schema y deberías ver la lista de tablas en TPCD:

¡Ya está todo listo para crear visualizaciones en Tableau!

​
Creación de visualizaciones en Tableau

Ahora que tenemos un origen de datos de ClickHouse configurado en Tableau, vamos a visualizar los datos…
  1. Arrastra la tabla CUSTOMER al libro de trabajo. Observa que aparecen las columnas, pero la tabla de datos está vacía:

  1. Haz clic en el botón Update Now y 100 filas de CUSTOMER se cargarán en la tabla.
  2. Arrastra la tabla ORDERS al libro de trabajo y, a continuación, establece Custkey como el campo de relación entre las dos tablas:

  1. Ahora tienes las tablas ORDERS y LINEITEM asociadas entre sí como origen de datos, así que puedes usar esta relación para responder preguntas sobre los datos. Selecciona la pestaña Sheet 1 en la parte inferior del libro de trabajo.

  1. Supón que quieres saber cuántos artículos concretos se pidieron cada año. Arrastra OrderDate de ORDERS a la sección Columns (el campo horizontal) y, a continuación, arrastra Quantity de LINEITEM a Rows. Tableau generará el siguiente gráfico de líneas:

No es un gráfico de líneas muy interesante, pero el conjunto de datos se generó mediante un script y se creó para probar el rendimiento de las consultas, así que notarás que no hay mucha variación en los pedidos simulados de los datos TCPD.
  1. Supón que quieres conocer el importe medio de los pedidos (en dólares) por trimestre y también por modo de envío (aire, correo, barco, camión, etc.):
    • Haz clic en la pestaña New Worksheet para crear una hoja nueva
    • Arrastra OrderDate de ORDERS a Columns y cámbialo de Year a Quarter
    • Arrastra Shipmode de LINEITEM a Rows
Deberías ver lo siguiente:
  1. Los valores Abc solo están ocupando espacio hasta que arrastres una métrica a la tabla. Arrastra Totalprice de * ORDERS* a la tabla. Observa que el cálculo predeterminado es SUM de Totalprices:

  1. Haz clic en SUM y cambia Measure a Average. En el mismo menú desplegable, selecciona Format y cambia Numbers a Currency (Standard):

¡Bien hecho! Has conectado Tableau a ClickHouse correctamente y has abierto todo un mundo de posibilidades para analizar y visualizar tus datos de ClickHouse.

​
Instala el conector manualmente

Si usas una versión desactualizada de Tableau Desktop que no incluye el conector de forma predeterminada, puedes instalarlo manualmente siguiendo estos pasos:
  1. Descarga el archivo taco más reciente desde Tableau Exchange
  2. Coloca el archivo taco en
    • macOS: ~/Documents/My Tableau Repository/Connectors
    • Windows: C:\Users\[Windows User]\Documents\My Tableau Repository\Connectors
  3. Reinicia Tableau Desktop; si la instalación se completó correctamente, encontrarás el conector en la sección New Data Source.

​
Consejos de conexión y análisis

Para obtener más información sobre cómo optimizar su integración de Tableau con ClickHouse, visite Consejos de conexión y Consejos de análisis.

​
Pruebas

El conector se prueba con el framework TDVT y actualmente alcanza una cobertura del 97 %.

​
Resumen

Puedes conectar Tableau a ClickHouse mediante el controlador genérico ODBC/JDBC de ClickHouse. Sin embargo, este conector simplifica el proceso de configuración de la conexión. Si tienes algún problema con el conector, no dudes en ponerte en contacto en GitHub.
Última modificación el 10 de junio de 2026