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.
Abrir esta conexión en SQLly
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 clave | Sinónimos | Predeterminado | Lo 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 clave | Sinónimos | Predeterminado | Lo 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 clave | Sinónimos | Predeterminado | Lo 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 clave | Sinónimos | Predeterminado | Lo 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.
Otros motores
- Cadenas de conexión de SQL Server
- Cadenas de conexión de PostgreSQL
- Cadenas de conexión de MySQL
- Cadenas de conexión de MariaDB
- Cadenas de conexión de SQLite
- Cadenas de conexión de Oracle
- Cadenas de conexión de Redis
- Cadenas de conexión de DuckDB
- Cadenas de conexión de libSQL
- Todos los motores y formatos
- Formateador SQL
- Todas las herramientas gratuitas
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.