Conectar DataGrip a ClickHouse

DataGrip es un IDE para bases de datos compatible con ClickHouse de forma nativa.

​

Inicie o descargue DataGrip

DataGrip está disponible en https://www.jetbrains.com/datagrip/

​

1. Reúne los datos de conexión

Para conectarse a ClickHouse con HTTP(S), necesita esta información:

Parámetro(s)	Descripción
HOST and PORT	Normalmente, el puerto es 8443 cuando se usa TLS o 8123 cuando no se usa TLS.
DATABASE NAME	De forma predeterminada, existe una base de datos llamada default; use el nombre de la base de datos a la que desea conectarse.
USERNAME and PASSWORD	De forma predeterminada, el nombre de usuario es default. Use el nombre de usuario adecuado para su caso de uso.

Los detalles de su servicio de ClickHouse Cloud están disponibles en la consola de ClickHouse Cloud. Seleccione un servicio y haga clic en Connect:

Elija HTTPS. Los detalles de conexión se muestran en un comando curl de ejemplo.

Si usa ClickHouse autogestionado, los detalles de conexión los establece su administrador de ClickHouse.

​

2. Cargue el driver de ClickHouse

1. Inicie DataGrip y, en la pestaña Data Sources del cuadro de diálogo Data Sources and Drivers, haga clic en el icono +

Seleccione ClickHouse

A medida que establezca connections, el orden cambia; es posible que ClickHouse todavía no aparezca al principio de la lista.

• Cambie a la pestaña Drivers y cargue el driver de ClickHouse

  DataGrip no incluye drivers para minimizar el tamaño de la descarga. En la pestaña Drivers, seleccione ClickHouse en la lista Complete Support y expanda el signo +. Elija el driver Latest stable en la opción Provided Driver:

​

3. Conéctate a ClickHouse

• Especifica los datos de conexión de tu base de datos y haz clic en Test Connection. En el primer paso recopilaste esos datos: completa la URL del host, el puerto, el nombre de usuario, la contraseña y el nombre de la base de datos, y luego prueba la conexión.

Introduce solo el hostname en el campo Host (por ejemplo, your-host.clickhouse.cloud) sin ningún prefijo de protocolo, como https://.

Para las conexiones de ClickHouse Cloud, debes añadir ?ssl=true al campo URL debajo del host. La URL JDBC completa debe verse así:

jdbc:clickhouse://your-host.clickhouse.cloud:8443/default?ssl=true

ClickHouse Cloud requiere cifrado SSL para todas las conexiones. Sin el parámetro ?ssl=true, verás errores de “Connection reset” incluso con las credenciales correctas.

Para obtener más información sobre la configuración de la URL JDBC, consulta el repositorio del ClickHouse JDBC driver.

​

Más información

Para obtener más información sobre DataGrip, consulta la documentación de DataGrip.