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

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

export const e_1 = undefined

export const e_0 = undefined

<a href="/docs/get-started/quickstarts/home" onClick={(e_0) => { e_0.preventDefault(); window.location.href = (window.location.pathname.startsWith('/docs') ? '/docs' : '') + '/get-started/quickstarts/home'; }} className="inline-flex items-center gap-1.5 text-sm text-gray-500 dark:text-zinc-500 hover:text-gray-900 dark:hover:text-[#fdff75] transition-colors font-normal no-underline"><svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="shrink-0"><path d="M19 12H5" /><path d="M12 19l-7-7 7-7" /></svg>All quickstarts</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 [ClickHouse Cloud quick start](/docs/get-started/setup/cloud) first.

También deberías haber completado la guía [Inicio rápido de ClickHouse Cloud](/docs/es/get-started/setup/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 title="Abre la consola de Cloud" id="open-the-cloud-console">
    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 title="Encuentra tus detalles de conexión" id="find-your-connection-details">
    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/fc_oxFgK6Bxv68B9/images/get-started/quickstarts/connect-light.webp?fit=max&auto=format&n=fc_oxFgK6Bxv68B9&q=85&s=77d5d2fcac02a3c971a245a0d5a803d6" alt="Botón Connect en la consola de ClickHouse Cloud (modo claro)" width="1050" height="964" data-path="images/get-started/quickstarts/connect-light.webp" />

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

    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 title="Comprende los protocolos de conexión" id="understand-the-connection-protocols">
    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 title="Guarda tus detalles de conexión para reutilizarlos" id="save-your-connection-details-for-reuse">
    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>

<div id="next-steps">
  ## Siguientes pasos
</div>

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](/docs/es/get-started/quickstarts/insert-data-using-clickhouse-client)
* [Crear tu primera tabla MergeTree](/docs/es/get-started/quickstarts/create-your-first-mergetree-table)

O profundiza con la documentación de referencia:

* [Interfaz nativa (TCP)](/docs/es/concepts/features/interfaces/tcp)
* [Interfaz HTTP](/docs/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/EDr8ydtGBgFPOQea/images/academy.webp?fit=max&auto=format&n=EDr8ydtGBgFPOQea&q=85&s=27e92fc656183cc2f176211907a7aa49" alt="ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level" width="560" noZoom data-path="images/academy.webp" />
  </a>
</Frame>

<div className="mt-8">
  <a href="/docs/get-started/quickstarts/home" onClick={(e_1) => { e_1.preventDefault(); window.location.href = (window.location.pathname.startsWith('/docs') ? '/docs' : '') + '/get-started/quickstarts/home'; }} className="inline-flex items-center gap-1.5 text-sm text-gray-500 dark:text-zinc-500 hover:text-gray-900 dark:hover:text-[#fdff75] transition-colors font-normal no-underline"><svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="shrink-0"><path d="M19 12H5" /><path d="M12 19l-7-7 7-7" /></svg>All quickstarts</a>
</div>