> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar Chartbrew con ClickHouse

> Conecta Chartbrew con ClickHouse para crear dashboards en tiempo real e informes para clientes.

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>;
};

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            Mantenimiento de la comunidad
        </div>;
};

[Chartbrew](https://chartbrew.com) es una plataforma de visualización de datos que te permite crear dashboards y supervisar los datos en tiempo real. Admite múltiples fuentes de datos, entre ellas ClickHouse, y ofrece una interfaz sin código para crear gráficos e informes.

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

En esta guía, conectarás Chartbrew a ClickHouse, ejecutarás una consulta SQL y crearás una visualización. Al final, tu dashboard podría verse así:

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/chartbrew_01.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=23dff66591d362f71a3cb6b1eabbe667" size="lg" alt="Dashboard de Chartbrew" width="2400" height="1289" data-path="images/integrations/data-visualization/chartbrew_01.webp" />

<Tip>
  **Agrega algunos datos**

  Si no tienes un conjunto de datos con el que trabajar, puedes agregar uno de los conjuntos de datos de ejemplo. Esta guía utiliza el conjunto de datos [UK Price Paid](/es/get-started/sample-datasets/uk-price-paid).
</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-postgresql-tls-support/cTIaEq6k6KYDgBI1/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=cTIaEq6k6KYDgBI1&q=85&s=dd441fc2272e292760011d48e81d43d4" 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-postgresql-tls-support/cTIaEq6k6KYDgBI1/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=cTIaEq6k6KYDgBI1&q=85&s=878b1fe94ea520377426f69503e38994" 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-connect-chartbrew-to-clickhouse">
  ## 2. Conecta Chartbrew a ClickHouse
</div>

1. Inicia sesión en [Chartbrew](https://chartbrew.com/login) y ve a la pestaña **Connections**.

2. Haz clic en **Create connection** y selecciona **ClickHouse** entre las opciones de bases de datos disponibles.

   <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/chartbrew_02.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=ad264029c8d22875f7e9874b5eaa41da" size="lg" alt="Selecciona la conexión de ClickHouse en Chartbrew" width="1600" height="1132" data-path="images/integrations/data-visualization/chartbrew_02.webp" />

3. Introduce los datos de conexión de tu base de datos de ClickHouse:

   * **Display Name**: Un nombre para identificar la conexión en Chartbrew.
   * **Host**: El hostname o la dirección IP de tu servidor de ClickHouse.
   * **Port**: Normalmente, `8443` para conexiones HTTPS.
   * **Database Name**: La base de datos a la que quieres conectarte.
   * **Username**: Tu nombre de usuario de ClickHouse.
   * **Password**: Tu contraseña de ClickHouse.

   <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/chartbrew_03.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=adf8307a46b3f792f83e2c597b55c25f" size="lg" alt="Configuración de la conexión de ClickHouse en Chartbrew" width="1600" height="1141" data-path="images/integrations/data-visualization/chartbrew_03.webp" />

4. Haz clic en **Test connection** para comprobar que Chartbrew puede conectarse a ClickHouse.

5. Si la prueba se realiza correctamente, haz clic en **Save connection**. Chartbrew recuperará automáticamente el esquema desde ClickHouse.

   <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/chartbrew_04.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=b44acb44340957671e8925c7cc04b7b2" size="lg" alt="Esquema JSON de ClickHouse en Chartbrew" width="1600" height="855" data-path="images/integrations/data-visualization/chartbrew_04.webp" />

<div id="3-create-a-dataset-and-run-a-sql-query">
  ## 3. Crear un conjunto de datos y ejecutar una consulta SQL
</div>

1. Haz clic en el botón **Crear conjunto de datos** o ve a la pestaña **Conjuntos de datos** para crear uno.
2. Selecciona la conexión de ClickHouse que creaste antes.

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/chartbrew_05.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=2fc2348b53de30c75b5379e8d4f54a5b" size="lg" alt="Selecciona la conexión de ClickHouse para el conjunto de datos" width="1600" height="725" data-path="images/integrations/data-visualization/chartbrew_05.webp" />

Escribe una consulta SQL para obtener los datos que quieras visualizar. Por ejemplo, esta consulta calcula el precio medio pagado por año a partir del conjunto de datos `uk_price_paid`:

```sql theme={null}
  SELECT toYear(date) AS year, avg(price) AS avg_price
  FROM uk_price_paid
  GROUP BY year
  ORDER BY year;
```

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/chartbrew_07.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=d9e9fa6fed5bee2d2937603aaef7bfde" size="lg" alt="Consulta SQL de ClickHouse en Chartbrew" width="1600" height="928" data-path="images/integrations/data-visualization/chartbrew_07.webp" />

Haz clic en **Run query** para obtener los datos.

Si no estás seguro de cómo escribir la consulta, puedes usar el **asistente de IA de Chartbrew** para generar consultas SQL basadas en el esquema de tu base de datos.

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/chartbrew_06.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=236983206e00aa48a8c75b6238c8fb2f" size="lg" alt="Asistente de IA SQL de ClickHouse en Chartbrew" width="2400" height="1184" data-path="images/integrations/data-visualization/chartbrew_06.webp" />

Una vez obtenidos los datos, haz clic en **Configure conjunto de datos** para configurar los parámetros de la visualización.

<div id="4-create-a-visualization">
  ## 4. Crear una visualización
</div>

1. Defina una métrica (valor numérico) y una dimensión (valor categórico) para su visualización.
2. Obtenga una vista previa del conjunto de datos para asegurarse de que los resultados de la consulta tengan la estructura correcta.
3. Elija un tipo de gráfico (p. ej., gráfico de líneas, gráfico de barras o gráfico circular) y añádalo a su dashboard.
4. Haga clic en **Complete conjunto de datos** para finalizar la configuración.

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/chartbrew_08.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=2724878d6d1e3cc75579f2de8f816b86" size="lg" alt="Dashboard de Chartbrew con datos de ClickHouse" width="2400" height="1068" data-path="images/integrations/data-visualization/chartbrew_08.webp" />

Puede crear tantos conjuntos de datos como desee para visualizar distintos aspectos de sus datos. Con estos conjuntos de datos, puede crear varios dashboards para realizar un seguimiento de diferentes métricas.

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/chartbrew_01.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=23dff66591d362f71a3cb6b1eabbe667" size="lg" alt="Dashboard de Chartbrew con datos de ClickHouse" width="2400" height="1289" data-path="images/integrations/data-visualization/chartbrew_01.webp" />

<div id="5-automate-data-updates">
  ## 5. Automatiza las actualizaciones de datos
</div>

Para mantener tu dashboard actualizado, puedes programar actualizaciones automáticas de datos:

1. Haz clic en el icono del calendario junto al botón de actualización del conjunto de datos.
2. Configura el intervalo de actualización (p. ej., cada hora o cada día).
3. Guarda la configuración para habilitar la actualización automática.

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/chartbrew_09.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=af55c85f0d22cd0291178bc09e02c4e5" size="lg" alt="Configuración de actualización del conjunto de datos en Chartbrew" width="1600" height="899" data-path="images/integrations/data-visualization/chartbrew_09.webp" />

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

Para obtener más información, consulta la entrada del blog sobre [Chartbrew y ClickHouse](https://chartbrew.com/blog/visualizing-clickhouse-data-with-chartbrew-a-step-by-step-guide/).
