> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. > Tableau puede usar bases de datos y tablas de ClickHouse como origen de datos. # Conexión de Tableau con ClickHouse export const ClickHouseSupportedBadge = () => { return
Compatible con ClickHouse
; }; export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return
{alt}
; }; ClickHouse ofrece un conector oficial para Tableau, disponible en el [Tableau Exchange](https://exchange.tableau.com/products/1064). El conector se basa en el avanzado [JDBC driver](/es/integrations/language-clients/java/jdbc) 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 `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. 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](https://github.com/ClickHouse/clickhouse-java/releases). Este artefacto está disponible a partir de la versión `0.9.2`. 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.
## 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: Pantalla de conexión de Tableau que muestra el menú de selección de conectores con la opción ClickHouse by ClickHouse resaltada
¿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](#install-the-connector-manually). 3. Haz clic en **ClickHouse by ClickHouse** y aparecerá el siguiente cuadro de diálogo: Cuadro de diálogo de instalación del conector de Tableau que muestra los detalles del conector ClickHouse JDBC y el botón de instalación
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: Cuadro de diálogo de conexión de ClickHouse en Tableau que muestra campos para server, port, database, username y password
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 | \*\*\*\*\*\* | 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). 7. Haz clic en el botón **Sign In** y deberías ver un nuevo libro de trabajo de Tableau: Nuevo libro de trabajo de Tableau que muestra la pantalla de conexión inicial con opciones de selección de base de datos
8. Selecciona **TPCD** en el desplegable **Schema** y deberías ver la lista de tablas en **TPCD**: Selección de schema en Tableau que muestra las tablas de la base de datos TPCD, incluidas CUSTOMER, LINEITEM, NATION, ORDERS y otras
¡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: Libro de trabajo de Tableau con la tabla CUSTOMER arrastrada al lienzo, mostrando encabezados de columnas pero sin datos
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: Editor de relaciones de Tableau que muestra la conexión entre las tablas CUSTOMER y ORDERS mediante el campo Custkey
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. Hoja de trabajo de Tableau que muestra las dimensiones y medidas de las tablas de ClickHouse disponibles para el análisis
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: Gráfico de líneas de Tableau que muestra la cantidad pedida por año a partir de datos de ClickHouse
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: Vista de tabla cruzada de Tableau con trimestres como columnas y modos de envío como filas
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**: Tabla cruzada de Tableau que muestra la suma del precio total por trimestre y modo de envío
8. Haz clic en **SUM** y cambia **Measure** a **Average**. En el mismo menú desplegable, selecciona **Format** y cambia **Numbers** a **Currency (Standard)**: Tabla cruzada de Tableau que muestra el precio medio de los pedidos por trimestre y modo de envío con formato de moneda
¡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](https://exchange.tableau.com/products/1064) 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](/es/integrations/connectors/data-visualization/tableau/tableau-connection-tips) y [Consejos de análisis](/es/integrations/connectors/data-visualization/tableau/tableau-analysis-tips).
## Pruebas
El conector se prueba con el [framework TDVT](https://tableau.github.io/connector-plugin-sdk/docs/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.