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

> Metabase es una herramienta de UI de código abierto y fácil de usar para consultar datos.

# Conectar Metabase con ClickHouse

export const PartnerBadge = () => {
  return <div className="PartnerBadge">
            <div className="PartnerBadgeIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <polyline points="12.5 9.5 10 12 6 11 2.5 8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="4.54 4.41 8 3.5 11.46 4.41" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M2.15,3.78 L0.55,6.95 A0.5,0.5 0,0,0 0.77,7.62 L2.5,8.5 L4.54,4.41 L2.82,3.55 A0.5,0.5 0,0,0 2.15,3.78 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M13.5,8.5 L15.23,7.62 A0.5,0.5 0,0,0 15.45,6.95 L13.85,3.78 A0.5,0.5 0,0,0 13.18,3.55 L11.46,4.41 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M11.5,4.5 L9,4.5 L6.15,7.27 A0.5,0.5 0,0,0 6.24,8.05 C7.33,8.74 8.81,8.72 10,7.5 L12.5,9.5 L13.5,8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="7.75 13.5 5.15 12.85 3.5 11.67" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                </svg>
            </div>
            Integración de partner
        </div>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

Metabase es una herramienta de interfaz de usuario de código abierto y fácil de usar para hacer preguntas sobre tus datos. Metabase es una aplicación Java que puede ejecutarse simplemente <a href="https://www.metabase.com/start/oss/jar" target="_blank">descargando el archivo JAR</a> y ejecutándola con `java -jar metabase.jar`. Metabase se conecta a ClickHouse mediante un driver JDBC que descargas y colocas en la carpeta `plugins`:

<div id="goal">
  ## Objetivo
</div>

En esta guía consultarás tus datos de ClickHouse con Metabase y visualizarás las respuestas. Una de ellas se verá así:

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_08.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=ed3177332a1002ccce163945a51229d1" alt="Visualización de gráfico circular de Metabase que muestra datos de ClickHouse" border width="1222" height="893" data-path="images/integrations/data-visualization/metabase_08.webp" />

<p />

<Tip>
  **Añade algunos datos**

  Si no tienes un conjunto de datos con el que trabajar, puedes añadir uno de los ejemplos. Esta guía utiliza el conjunto de datos [UK Price Paid](/es/get-started/sample-datasets/uk-price-paid), así que puedes elegir ese. Hay varios más en la misma categoría de la documentación.
</Tip>

<div id="1-gather-your-connection-details">
  ## 1. Reúne los datos de conexión
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2d1e2340e1ddccf3199ca1e41eeba836" size="md" alt="Botón Connect del servicio de ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />

Elija **HTTPS**. Los detalles de conexión se muestran en un comando `curl` de ejemplo.

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2ea2af378046d5ec87ea8e78de573bc1" size="md" alt="Detalles de conexión HTTPS de ClickHouse Cloud" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />

Si usa ClickHouse autogestionado, los detalles de conexión los establece su administrador de ClickHouse.

<div id="2--download-the-clickhouse-plugin-for-metabase">
  ## 2.  Descargar el plugin de ClickHouse para Metabase
</div>

1. Si no tienes una carpeta `plugins`, crea una como subcarpeta en la misma ubicación en la que tengas guardado `metabase.jar`.

2. El plugin es un archivo JAR llamado `clickhouse.metabase-driver.jar`. Descarga la versión más reciente del archivo JAR desde <a href="https://github.com/clickhouse/metabase-clickhouse-driver/release" target="_blank">[https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest](https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest)</a>

3. Guarda `clickhouse.metabase-driver.jar` en tu carpeta `plugins`.

4. Inicia (o reinicia) Metabase para que el driver se cargue correctamente.

5. Accede a Metabase en <a href="http://localhost:3000/" target="_blank">[http://hostname:3000](http://hostname:3000)</a>. Al iniciarlo por primera vez, verás una pantalla de bienvenida y tendrás que responder una serie de preguntas. Si se te pide seleccionar una base de datos, selecciona "**Añadiré mis datos más tarde**":

<div id="3--connect-metabase-to-clickhouse">
  ## 3.  Conecta Metabase a ClickHouse
</div>

1. Haz clic en el icono del engranaje de la esquina superior derecha y selecciona **Admin Settings** para ir a tu <a href="http://localhost:3000/admin/settings/setup" target="_blank">página de administración de Metabase</a>.

2. Haz clic en **Add a database**. También puedes hacer clic en la pestaña **Databases** y seleccionar el botón **Add database**.

3. Si la instalación del driver funcionó, verás **ClickHouse** en el menú desplegable de **Database type**:

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_01.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=a5220dc3f694834daa750814c6de5c9f" alt="Selección de base de datos en Metabase que muestra ClickHouse como una opción" border width="1168" height="504" data-path="images/integrations/data-visualization/metabase_01.webp" />

4. Asigna a tu base de datos un **Display name**, que es una configuración de Metabase, así que puedes usar el nombre que prefieras.

5. Introduce los datos de conexión de tu base de datos de ClickHouse. Habilita una conexión segura si tu servidor de ClickHouse está configurado para usar SSL. Por ejemplo:

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_02.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=05c38065e8d96c5b98936ec7d7dc8d22" alt="Formulario de datos de conexión de Metabase para una base de datos de ClickHouse" border width="682" height="1020" data-path="images/integrations/data-visualization/metabase_02.webp" />

6. Haz clic en el botón **Save** y Metabase analizará tu base de datos en busca de tablas.

<div id="4-run-a-sql-query">
  ## 4. Ejecutar una consulta SQL
</div>

1. Sal de **Admin settings** haciendo clic en el botón **Exit admin** de la esquina superior derecha.

2. En la esquina superior derecha, haz clic en el menú **+ New** y verás que puedes hacer preguntas, ejecutar consultas SQL y crear un panel:

   <Image size="sm" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_03.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=a47bdbefbe0a384f44aea395faf995c7" alt="Menú New de Metabase que muestra opciones para crear preguntas, consultas SQL y paneles" border width="283" height="322" data-path="images/integrations/data-visualization/metabase_03.webp" />

3. Por ejemplo, aquí tienes una consulta SQL ejecutada en una tabla llamada `uk_price_paid` que devuelve el precio medio pagado por año entre 1995 y 2022:

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_04.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=5951b26162f74f2cecc6b7b8c16e7f4a" alt="Editor SQL de Metabase que muestra una consulta sobre datos de precios pagados en el Reino Unido" border width="674" height="1003" data-path="images/integrations/data-visualization/metabase_04.webp" />

<div id="5-ask-a-question">
  ## 5. Haz una pregunta
</div>

1. Haz clic en **+ New** y selecciona **Question**. Ten en cuenta que puedes crear una pregunta a partir de una base de datos y una tabla. Por ejemplo, la siguiente pregunta se plantea sobre una tabla llamada `uk_price_paid` en la base de datos `default`. Aquí tienes una pregunta sencilla que calcula el precio medio por localidad dentro del condado de Greater Manchester:

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_06.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=944434a8031be4118313eb8fe33d56af" alt="Interfaz de creación de preguntas de Metabase con datos de precios del Reino Unido" border width="869" height="1049" data-path="images/integrations/data-visualization/metabase_06.webp" />

2. Haz clic en el botón **Visualize** para ver los resultados en una vista de tabla.

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_07.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=3b06e3197791ffbbeb6842c96e464a01" alt="Visualización de Metabase que muestra resultados en tabla de los precios medios por localidad" border width="1222" height="893" data-path="images/integrations/data-visualization/metabase_07.webp" />

3. Debajo de los resultados, haz clic en el botón **Visualization** para cambiar la visualización a un gráfico de barras (o cualquiera de las otras opciones disponibles):

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_08.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=ed3177332a1002ccce163945a51229d1" alt="Visualización de gráfico circular de Metabase de los precios medios por localidad en Greater Manchester" border width="1222" height="893" data-path="images/integrations/data-visualization/metabase_08.webp" />

<div id="learn-more">
  ## Más información
</div>

Para obtener más información sobre Metabase y sobre cómo crear paneles, <a href="https://www.metabase.com/docs/latest/" target="_blank">visita la documentación de Metabase</a>.
