// herramienta gratuita

Generador de cadenas de conexión de ClickHouse

Crea cadenas de conexión de ClickHouse para la interfaz HTTP y el protocolo nativo desde un solo formulario, o pega una para verificar el puerto, el protocolo y la configuración de TLS. Todo se ejecuta en tu navegador: nada de lo que escribas se envía a ningún lugar.

Abrir esta conexión en SQLly

Abre el editor de conexiones de SQLly con los datos ya rellenados.

Privado por diseño. El constructor y el decodificador son JavaScript puro que se ejecuta en esta pestaña. La página no envía ninguna solicitud con lo que escribes, no almacena nada (ni siquiera en tu navegador) y sigue funcionando sin conexión una vez cargada. El enlace Abrir en SQLly va directamente desde tu navegador a la aplicación en tu computadora.

Formatos de cadenas de conexión de ClickHouse

ClickHouse tiene dos protocolos de cliente en diferentes puertos: HTTP (8123, o 8443 con TLS), usado por JDBC, clickhouse-connect y el controlador .NET, y el protocolo TCP nativo (9000, o 9440 con TLS), usado por clickhouse-client y clickhouse-go. Apuntar un cliente al puerto del otro protocolo es el error de conexión más común.

URL HTTP Interfaz HTTP, curl

https://ch.example.com:8443/?database=analytics

DSN nativo clickhouse-go v2

clickhouse://default:[email protected]:9440/analytics?secure=true

JDBC clickhouse-java 0.8+

jdbc:clickhouse:https://ch.example.com:8443/analytics?user=default&password=your_password&ssl=true

ADO.NET ClickHouse.Driver

Host=ch.example.com;Protocol=https;Username=default;Password=your_password;Database=analytics

Los marcadores de posición como your_password son eso mismo: construye tu propia cadena con el formulario de arriba. Más sobre cómo conectar SQLly a ClickHouse: SQLly para ClickHouse.

Puertos de ClickHouse

De la guía de puertos de red de ClickHouse.

Palabra claveSinónimosPredeterminadoLo que hace
8123 - - Interfaz HTTP.
8443 - - Interfaz HTTPS.
9000 - - Protocolo TCP nativo.
9440 - - Protocolo nativo sobre TLS.
9004 / 9005 - - Interfaces compatibles con el protocolo de MySQL y PostgreSQL.

Parámetros DSN de clickhouse-go v2

clickhouse://user:password@host1:9000,host2:9000/database?param=value; http:// y https:// Los DSN usan la interfaz HTTP.

Palabra claveSinónimosPredeterminadoLo que hace
secure - falso TLS.
skip_verify - falso Omitir verificaciones de certificado.
dial_timeout - 30s Tiempo de espera de conexión con unidad.
read_timeout - 5m Tiempo de espera de lectura.
compress - - Método de compresión.
connection_open_strategy - - Cómo se seleccionan los hosts.

Claves de ClickHouse.Driver (.NET)

Estilo ADO.NET.

Palabra claveSinónimosPredeterminadoLo que hace
Host - localhost Host del servidor.
Port - 8123 / 8443 Puerto HTTP(S).
Protocol - http http o https.
Username - default Nombre de usuario.
Password - vacía Contraseña.
Database - vacía Base de datos predeterminada.
Compression - verdadero Comprimir tráfico.
UseSession - falso Usa una sesión del lado del servidor.
Timeout - 120 Segundos.

opciones de clickhouse-client

clickhouse-client también acepta una cadena de conexión como su primer argumento: clickhouse:[//[user[:password]@][hosts_and_ports]][/database][?query_parameters].

Palabra claveSinónimosPredeterminadoLo que hace
--host, -h - localhost Host del servidor.
--port - 9000 (9440 con --secure) Puerto nativo.
--user, -u - default Usuario.
--password --ask-password - Contraseña; --ask-password solicita.
--database, -d - default Base de datos.
--secure, -s - - TLS; activado automáticamente para el puerto 9440 y los hosts de ClickHouse Cloud.

Errores comunes de conexión a ClickHouse

Port 9000 is for clickhouse-client program. You must use port 8123 for HTTP.

Por qué: Un cliente HTTP (navegador, curl, JDBC, clickhouse-connect, .NET) apuntaba al puerto del protocolo nativo.

Solución: Usa 8123 u 8443 para HTTPS.

Code: 516. DB::Exception: default: Authentication failed: password is incorrect, or there is no user with such name.

Por qué: Usuario o contraseña incorrectos, o puede que el usuario no tenga permiso para iniciar sesión desde tu dirección.

Solución: Verifica las credenciales y los hosts permitidos del usuario en la configuración de usuarios del servidor.

Code: 81. DB::Exception: Database analytics does not exist. (UNKNOWN_DATABASE)

Por qué: La base de datos en la cadena no existe.

Solución: Comprobar SHOW DATABASES y la ortografía.

Unexpected packet / connection reset on the native port

Por qué: Un cliente de protocolo nativo (clickhouse-client, clickhouse-go) está hablando con un puerto HTTP, o un cliente normal con el puerto TLS 9440.

Solución: Usa 9000 sin TLS o 9440 con --secure / secure=true.

Preguntas frecuentes sobre la cadena de conexión de ClickHouse

¿Qué puerto debo usar para ClickHouse?

Los clientes HTTP (JDBC, clickhouse-connect, .NET, curl) usan 8123, o 8443 para HTTPS. Los clientes nativos (clickhouse-client, clickhouse-go native DSN) usan 9000, o 9440 para TLS. ClickHouse Cloud ofrece 8443 y 9440.

¿Cuál es el formato de URL JDBC de ClickHouse?

jdbc:clickhouse:http://host:8123/database o jdbc:clickhouse:https://host:8443/database?ssl=true (controlador 0.8+). El controlador no deduce el protocolo a partir del puerto, así que escríbelo.

¿Puedo poner la contraseña en la URL HTTP?

Evítalo: las URLs terminan en los registros. Envíala en las X-ClickHouse-User y X-ClickHouse-Key encabezados, o con autenticación básica HTTP.

// olvídate de las cadenas por completo

Conéctate una vez. Luego solo escribe SQL.

SQLly es un entorno de trabajo SQL nativo para macOS, Windows y Linux. Pega una cadena de conexión en su editor de conexiones, guarda las contraseñas en el llavero del sistema y obtén IntelliSense que entiende el esquema en ClickHouse, entre otros.