> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/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>;
};

<PartnerBadge />

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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_08.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=87b54ca62deb669566b0a67ceac7e478" 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](/docs/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>

<Steps>
  <Step title="Reúne tus datos de conexión" id="1-gather-your-connection-details">
    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**:

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="Botón Connect del servicio de ClickHouse Cloud" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
      </Frame>
    </div>

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

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="Detalles de conexión HTTPS de ClickHouse Cloud" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
      </Frame>
    </div>

    Si usa ClickHouse autogestionado, los detalles de conexión los establece su administrador de ClickHouse.
  </Step>

  <Step title="Descarga el plugin de ClickHouse para Metabase" id="2--download-the-clickhouse-plugin-for-metabase">
    1. Si no tienes una carpeta `plugins`, crea una como subcarpeta en la ubicación donde 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 en <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>. La primera vez que se inicie, 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 "**Agregaré mis datos más tarde**":
  </Step>

  <Step title="Conecta Metabase a ClickHouse" id="3--connect-metabase-to-clickhouse">
    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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_01.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=586acaa7da62b005cdc30f06f2319f11" 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_02.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=42c1c15bc5fa13bbb2e3102f57fcf1ac" 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.
  </Step>

  <Step title="Ejecuta una consulta SQL" id="4-run-a-sql-query">
    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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_03.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=2e11e4ee4b8c466e146cf02e3aec5164" 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 sobre una tabla llamada `uk_price_paid` que devuelve el precio promedio pagado por año desde 1995 hasta 2022:

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_04.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=f868f4778e9a0a44e8f34485d3992e63" alt="SQL Editor de Metabase que muestra una consulta sobre datos de precio pagado del Reino Unido" border width="674" height="1003" data-path="images/integrations/data-visualization/metabase_04.webp" />
  </Step>

  <Step title="Haz una pregunta" id="5-ask-a-question">
    1. Haz clic en **+ New** y selecciona **Question**. Ten en cuenta que puedes crear una pregunta empezando por una base de datos y una tabla. Por ejemplo, la siguiente pregunta se hace sobre una tabla llamada `uk_price_paid` en la base de datos `default`. Aquí tienes una pregunta sencilla que calcula el precio promedio por localidad dentro del condado de Greater Manchester:

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_06.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=315caa354ba8213b40c642f3a3e1a9ca" alt="Interfaz del constructor 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 tabular.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_07.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=e3b7c74397644bd33510044a6d24bad7" alt="Visualización de Metabase que muestra resultados tabulares de precios promedio 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_08.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=87b54ca62deb669566b0a67ceac7e478" alt="Visualización de gráfico circular en Metabase de precios promedio por localidad en Greater Manchester" border width="1222" height="893" data-path="images/integrations/data-visualization/metabase_08.webp" />
  </Step>
</Steps>

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