Connexion de DataGrip à ClickHouse

DataGrip est un IDE de base de données compatible nativement avec ClickHouse.

​

Lancez ou téléchargez DataGrip

DataGrip est disponible sur https://www.jetbrains.com/datagrip/

​

1. Récupérez vos informations de connexion

Pour vous connecter à ClickHouse via HTTP(S), vous avez besoin des informations suivantes :

Paramètre(s)	Description
HOST and PORT	En général, le port est 8443 lors de l’utilisation de TLS, ou 8123 sans TLS.
DATABASE NAME	Par défaut, une base de données nommée default est disponible ; utilisez le nom de la base de données à laquelle vous voulez vous connecter.
USERNAME and PASSWORD	Par défaut, le nom d’utilisateur est default. Utilisez le nom d’utilisateur adapté à votre cas d’usage.

Les informations de votre service ClickHouse Cloud sont disponibles dans la console ClickHouse Cloud. Sélectionnez un service, puis cliquez sur Connect :

Choisissez HTTPS. Les détails de connexion s’affichent dans un exemple de commande curl.

Si vous utilisez ClickHouse autogéré, les détails de connexion sont définis par votre administrateur ClickHouse.

​

2. Charger le pilote ClickHouse

1. Lancez DataGrip, puis, dans l’onglet Data Sources de la boîte de dialogue Data Sources and Drivers, cliquez sur l’icône +

Sélectionnez ClickHouse

Au fur et à mesure que vous créez des connexions, l’ordre de la liste change ; ClickHouse n’apparaît donc peut-être pas encore en haut de votre liste.

• Basculez vers l’onglet Drivers et chargez le pilote ClickHouse

  DataGrip n’est pas livré avec les pilotes afin de réduire la taille du téléchargement. Dans l’onglet Drivers, sélectionnez ClickHouse dans la liste Complete Support, puis développez le signe +. Choisissez le pilote Latest stable dans l’option Provided Driver :

​

3. Se connecter à ClickHouse

• Indiquez les informations de connexion à votre base de données, puis cliquez sur Test Connection. À l’étape 1, vous avez récupéré vos informations de connexion : renseignez l’URL de l’hôte, le port, le nom d’utilisateur, le mot de passe et le nom de la base de données, puis testez la connexion.

Saisissez uniquement le nom d’hôte dans le champ Host (par ex. your-host.clickhouse.cloud), sans préfixe de protocole tel que https://.

Pour les connexions à ClickHouse Cloud, vous devez ajouter ?ssl=true dans le champ URL sous l’hôte. L’URL JDBC complète doit ressembler à ceci :

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

ClickHouse Cloud exige un chiffrement SSL pour toutes les connexions. Sans le paramètre ?ssl=true, vous verrez des erreurs « Connection reset » même avec des identifiants corrects.

Pour plus de détails sur les paramètres d’URL JDBC, veuillez consulter le dépôt ClickHouse JDBC driver.

​

En savoir plus

Pour en savoir plus sur DataGrip, consultez la documentation de DataGrip.