Skip to main content
Todas las guías de inicio rápido
Análisis en tiempo realData warehousingObservabilidadIA/MLCloud

​
Requisitos previos

To successfully follow this guide, you’ll need the following: También deberías haber completado la guía de inicio rápido Create your first Cloud service, ya que necesitarás un servicio existente de ClickHouse Cloud para obtener los detalles de conexión.

​
Lo que crearás

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

​
Abre la consola de Cloud

Ve a la consola de 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.
2

​
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:Botón Connect en la consola de ClickHouse Cloud (modo claro)La primera vez que hagas clic en este botón, verás un cuadro de diálogo con tus credenciales: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.
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.
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.
Si has perdido tu contraseña, puedes restablecerla desde la pestaña Settings de tu servicio en la consola de Cloud.
3

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

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

​
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: O profundiza con la documentación de referencia:
ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level

Check out the ClickHouse academy for on-demand and live training

Todas las guías de inicio rápido
Last modified on June 12, 2026