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

# Obtén los detalles de conexión de tu servicio en Cloud

> Aprende a encontrar el hostname, el puerto y las credenciales de tu servicio de ClickHouse Cloud para conectarte desde clientes externos, CLI y aplicaciones.

<a href="/es/get-started/quickstarts/home"><Badge size="lg" color="gray" icon="arrow-left">Todas las guías de inicio rápido</Badge></a>

<div className="mt-2 flex flex-wrap gap-2">
  <Badge size="lg" color="blue">Análisis en tiempo real</Badge>
  <Badge size="lg" color="blue">Data warehousing</Badge>
  <Badge size="lg" color="blue">Observabilidad</Badge>
  <Badge size="lg" color="blue">IA/ML</Badge>
  <Badge size="lg" color="orange">Cloud</Badge>
</div>

<div id="prerequisites">
  ## Requisitos previos
</div>

To successfully follow this guide, you'll need the following:

* A running ClickHouse Cloud service. If you don't have one yet, complete the [Create your first Cloud service](/get-started/quickstarts/create-your-first-service-on-cloud) quickstart first.

También deberías haber completado la guía de inicio rápido [Create your first Cloud service](/es/get-started/quickstarts/create-your-first-service-on-cloud), ya que necesitarás un servicio existente de ClickHouse Cloud para obtener los detalles de conexión.

<div id="what-youll-build">
  ## Lo que crearás
</div>

En esta guía de inicio rápido aprenderás a localizar los detalles de conexión de tu servicio de ClickHouse Cloud: el hostname, los números de puerto, el nombre de usuario y la contraseña que necesitas para conectarte desde cualquier cliente externo, herramienta de línea de comandos o aplicación.
Al final, sabrás dónde encontrar estos datos en la consola de Cloud y cómo verificar la conectividad con un sencillo comando `curl`, para que puedas conectarte desde herramientas como `clickhouse-local`, `clickhouse-client` o cualquier driver de ClickHouse.

<Steps titleSize="h3">
  <Step>
    ### Abre la consola de Cloud

    Ve a la [consola de ClickHouse Cloud](https://console.clickhouse.cloud/) e inicia sesión en tu cuenta.

    En el panel principal, localiza el servicio al que quieres conectarte. Si el servicio está inactivo, haz clic en él y espera a que se reactive antes de continuar; necesitarás que esté en ejecución para verificar la conectividad en un paso posterior.
  </Step>

  <Step>
    ### Encuentra tus detalles de conexión

    Haz clic en tu servicio para abrir su página de detalles y, a continuación, haz clic en el botón **Connect** de la barra lateral izquierda:

    <img className="block dark:hidden w-2/3 mx-auto" src="https://mintcdn.com/private-7c7dfe99-home-button/k6dUBbEUOmZKxz3v/images/get-started/quickstarts/connect-light.png?fit=max&auto=format&n=k6dUBbEUOmZKxz3v&q=85&s=bcada08a48f2f63f445e8a20ef5a7d8f" alt="Botón Connect en la consola de ClickHouse Cloud (modo claro)" width="1050" height="964" data-path="images/get-started/quickstarts/connect-light.png" />

    <img className="hidden dark:block w-2/3 mx-auto" src="https://mintcdn.com/private-7c7dfe99-home-button/k6dUBbEUOmZKxz3v/images/get-started/quickstarts/connect-dark.png?fit=max&auto=format&n=k6dUBbEUOmZKxz3v&q=85&s=1e40b31290d69bb5a9ec5387353cbe2b" alt="Botón Connect en la consola de ClickHouse Cloud (modo oscuro)" width="1034" height="960" data-path="images/get-started/quickstarts/connect-dark.png" />

    La primera vez que hagas clic en este botón, verás un cuadro de diálogo con tus credenciales:

    | Detalle               | Descripción                                  |
    | --------------------- | -------------------------------------------- |
    | **Nombre de usuario** | Tu nombre de usuario (normalmente `default`) |
    | **Contraseña**        | La contraseña generada para tu servicio      |

    También hay un menú desplegable con ejemplos preformateados de cadenas de conexión para distintos protocolos e interfaces (por ejemplo, `clickhouse-client`, HTTPS, JDBC, etc.) que puedes copiar directamente.

    <Warning>
      Descarga el archivo de credenciales o copia tu contraseña y guárdala en un lugar seguro. Una vez que cierres este cuadro de diálogo, no podrás volver a ver la contraseña.
    </Warning>

    También encontrarás el **hostname** de tu servicio en la página de detalles del servicio (por ejemplo, `abc123.us-east-1.aws.clickhouse.cloud`). Cópialo junto con tus credenciales; necesitarás ambos en los pasos restantes y en guías de inicio rápido posteriores.

    <Note>
      Si has perdido tu contraseña, puedes restablecerla desde la pestaña **Settings** de tu servicio en la consola de Cloud.
    </Note>
  </Step>

  <Step>
    ### Comprende los protocolos de conexión

    ClickHouse Cloud expone dos protocolos de red principales, cada uno en su propio puerto:

    * **Protocolo nativo (puerto 9440)** - Un protocolo binario utilizado por `clickhouse-client`, `clickhouse-local` y la mayoría de los drivers específicos de cada lenguaje. Es la opción más rápida y admite todas las funcionalidades de ClickHouse. TLS es obligatorio en Cloud.
    * **Protocolo HTTPS (puerto 8443)** - Una interfaz basada en HTTP útil para clientes REST, `curl`, herramientas web y drivers que prefieren HTTP. También requiere TLS en Cloud.

    Ambos protocolos requieren cifrado TLS al conectarse a ClickHouse Cloud; no puedes conectarte en texto sin cifrar. La mayoría de las herramientas gestionan esto automáticamente cuando especificas el puerto correcto, pero puede que necesites pasar la opción `--secure` o establecer `ssl=true`, según el cliente.

    Para la mayoría de las guías de inicio rápido y los flujos de trabajo de CLI de esta serie, usarás el **protocolo nativo en el puerto 9440**.
  </Step>

  <Step>
    ### Guarda tus detalles de conexión para reutilizarlos

    Usarás estos detalles de conexión con frecuencia en las guías de inicio rápido. Para no tener que volver a escribirlos cada vez, puedes exportarlos como variables de entorno en tu sesión de terminal:

    ```bash theme={null}
    export CLICKHOUSE_HOST=YOUR_HOST.clickhouse.cloud
    export CLICKHOUSE_USER=default
    export CLICKHOUSE_PASSWORD=YOUR_PASSWORD
    ```

    Sustituye los valores por tu hostname, nombre de usuario y contraseña reales.
    Si vas a conectarte a tu servicio de Cloud con `clickhouse-client` o `clickhouse-local`, obtén el hostname seleccionando 'Native' en el menú desplegable junto a "Connect with:".
    Copia el hostname que aparece después de `--host` en el ejemplo de conexión mostrado.

    <Warning>
      Estas variables de entorno solo se conservan durante la sesión actual de terminal. No almacenes contraseñas en archivos de perfil del shell (`.bashrc`, `.zshrc`) ni las incluyas en el control de versiones.
    </Warning>
  </Step>
</Steps>

## Siguientes pasos

Ahora ya tienes todos los detalles de conexión necesarios para conectarte a tu servicio de ClickHouse Cloud desde cualquier herramienta externa. El hostname, el puerto, el nombre de usuario y la contraseña que encontraste aquí se usarán en el resto de la serie de guías de inicio rápido.

A continuación, consulta estas guías de inicio rápido:

* [Insertar datos con clickhouse-client](/es/get-started/quickstarts/insert-data-using-clickhouse-client)
* [Crear tu primera tabla MergeTree](/es/get-started/quickstarts/create-your-first-mergetree-table)

O profundiza con la documentación de referencia:

* [Interfaz nativa (TCP)](/es/concepts/features/interfaces/tcp)
* [Interfaz HTTP](/es/concepts/features/interfaces/http)

<Frame caption="Check out the ClickHouse academy for on-demand and live training">
  <a href="https://learn.clickhouse.com/" target="_blank">
    <img src="https://mintcdn.com/private-7c7dfe99-home-button/iOJBcv5hu2da8lsi/images/academy.png?fit=max&auto=format&n=iOJBcv5hu2da8lsi&q=85&s=102d3dcf8c90c04e86d2494a4b35541f" alt="ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level" width="560" noZoom data-path="images/academy.png" />
  </a>
</Frame>

<div className="mt-8">
  <a href="/es/get-started/quickstarts/home"><Badge size="lg" color="gray" icon="arrow-left">Todas las guías de inicio rápido</Badge></a>
</div>
