Conexión de Tableau con ClickHouse

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.

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 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. Descarga e instala Tableau Desktop.

3. Sigue las instrucciones de clickhouse-tableau-connector-jdbc para descargar la versión compatible del ClickHouse JDBC driver.

4. 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
5. Configura un origen de datos de ClickHouse en Tableau y empieza a crear visualizaciones.

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:

3. Haz clic en ClickHouse by ClickHouse y aparecerá el siguiente cuadro de diálogo:

4. Haz clic en Install and Restart Tableau. Reinicia la aplicación.
5. 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:

6. Introduce los datos de conexión:

   Setting	Value
   Server	Tu host de ClickHouse (sin prefijos ni sufijos)
   Port	8443
   Database	default
   Username	default
   Password	******

7. Haz clic en el botón Sign In y deberías ver un nuevo libro de trabajo de Tableau:

8. 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!

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:

2. Haz clic en el botón Update Now y 100 filas de CUSTOMER se cargarán en la tabla.

3. Arrastra la tabla ORDERS al libro de trabajo y, a continuación, establece Custkey como el campo de relación entre las dos tablas:

4. 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.

5. 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.

6. 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:

7. 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:

8. 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.

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.

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.

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

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.