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

> Consulta de forma eficiente conjuntos de datos muy grandes, y analízalos y modélalos en un entorno de notebook conocido.

# Conecta ClickHouse con Deepnote

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>
            Community Maintained
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

<a href="https://www.deepnote.com/" target="_blank">Deepnote</a> es un notebook colaborativo de datos diseñado para que los equipos descubran y compartan conocimientos. Además de ser compatible con Jupyter, funciona en la nube y te ofrece un espacio centralizado para colaborar y trabajar de forma eficiente en proyectos de ciencia de datos.

Esta guía parte de la base de que ya tienes una cuenta de Deepnote y una instancia de ClickHouse en ejecución.

<div id="interactive-example">
  ## Ejemplo interactivo
</div>

Si desea explorar un ejemplo interactivo de cómo consultar ClickHouse desde los notebooks de datos de Deepnote, haga clic en el botón de abajo para iniciar un proyecto basado en una plantilla conectado al [ClickHouse playground](/es/get-started/sample-datasets/playground).

[<img src="https://deepnote.com/buttons/launch-in-deepnote.svg" alt="Iniciar en Deepnote" width="32" />](https://deepnote.com/launch?template=ClickHouse%20and%20Deepnote)

<div id="connect-to-clickhouse">
  ## Conéctate a ClickHouse
</div>

1. En Deepnote, selecciona la sección "Integrations" y haz clic en la tarjeta de ClickHouse.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/4Hi2sd8mn4aAdMgN/images/integrations/data-visualization/deepnote_01.png?fit=max&auto=format&n=4Hi2sd8mn4aAdMgN&q=85&s=853f0474026b4afc35c60a32107230db" alt="tarjeta de integración de ClickHouse" border width="3024" height="1368" data-path="images/integrations/data-visualization/deepnote_01.png" />

2. Introduce los datos de conexión de tu instancia de ClickHouse:

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-fix-nav-issues/1oh4rjwfuHRS2yL2/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=1oh4rjwfuHRS2yL2&q=85&s=81c1524ac8ac2dac27e1558f13fcfd29" size="md" alt="Botón Connect del servicio de ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.png" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/1oh4rjwfuHRS2yL2/images/_snippets/connection-details-https.png?fit=max&auto=format&n=1oh4rjwfuHRS2yL2&q=85&s=335e19954512afe36d735a736cd32be7" size="md" alt="Detalles de conexión HTTPS de ClickHouse Cloud" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.png" />

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

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/4Hi2sd8mn4aAdMgN/images/integrations/data-visualization/deepnote_02.png?fit=max&auto=format&n=4Hi2sd8mn4aAdMgN&q=85&s=ca6d9d95621b8a2bf179f9d351acd3b3" alt="cuadro de diálogo de detalles de ClickHouse" border width="1827" height="1061" data-path="images/integrations/data-visualization/deepnote_02.png" />

***NOTA:*** Si tu conexión a ClickHouse está protegida mediante una IP Access List, es posible que tengas que permitir las direcciones IP de Deepnote. Obtén más información en [la documentación de Deepnote](https://docs.deepnote.com/integrations/authorize-connections-from-deepnote-ip-addresses).

3. ¡Enhorabuena! Ya has integrado ClickHouse en Deepnote.

<div id="using-clickhouse-integration">
  ## Uso de la integración de ClickHouse.
</div>

1. Empieza conectándote a la integración de ClickHouse, a la derecha de tu notebook.

   <Image size="lg" img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/4Hi2sd8mn4aAdMgN/images/integrations/data-visualization/deepnote_03.png?fit=max&auto=format&n=4Hi2sd8mn4aAdMgN&q=85&s=eaaa7e26ddf8a1acb36f9e7bfe47042b" alt="Cuadro de diálogo de detalles de ClickHouse" border width="3008" height="1086" data-path="images/integrations/data-visualization/deepnote_03.png" />

2. Ahora crea un nuevo bloque de consulta de ClickHouse y consulta la base de datos. Los resultados de la consulta se guardarán como un DataFrame y se almacenarán en la variable especificada en el bloque SQL.

3. También puedes convertir cualquier [bloque SQL](https://docs.deepnote.com/features/sql-cells) existente en un bloque de ClickHouse.
