Set up docs MCPPrérequis
To successfully follow this guide, you’ll need the following:
- A running ClickHouse Cloud service. If you don’t have one yet, complete the ClickHouse Cloud quick start first.
Vous devez également avoir terminé le guide Démarrage rapide de ClickHouse Cloud, car vous aurez besoin d’un service ClickHouse Cloud existant pour en récupérer les informations de connexion.
Ce que vous allez mettre en place
Dans ce guide de démarrage rapide, vous apprendrez à trouver les informations de connexion de votre service ClickHouse Cloud : le nom d’hôte, les numéros de port, le nom d’utilisateur et le mot de passe nécessaires pour vous connecter depuis n’importe quel client externe, outil CLI ou application.
À la fin, vous saurez où trouver ces informations dans la console ClickHouse Cloud et comment vérifier la connectivité à l’aide d’une simple commande curl, afin d’être prêt à vous connecter depuis des outils comme clickhouse-local, clickhouse-client ou tout pilote ClickHouse.
Ouvrir la console ClickHouse Cloud
Accédez à la console ClickHouse Cloud et connectez-vous à votre compte.
Depuis le tableau de bord principal, repérez le service auquel vous souhaitez vous connecter. Si le service est en veille, cliquez dessus et attendez qu’il se réactive avant de continuer : il devra être en cours d’exécution pour vérifier la connectivité dans une étape ultérieure.
Trouver vos informations de connexion
Cliquez sur votre service pour ouvrir sa page de détails, puis sur le bouton Connect dans la barre latérale gauche :
La première fois que vous cliquez sur ce bouton, une boîte de dialogue affichant vos identifiants apparaît :
| Détail | Description |
|---|---|
| Username | Votre nom d’utilisateur (généralement default) |
| Password | Le mot de passe généré pour votre service |
Un menu déroulant propose également des exemples de chaînes de connexion préformatées pour différents protocoles et interfaces (par ex. clickhouse-client, HTTPS, JDBC, etc.), que vous pouvez copier directement.
Vous trouverez également le nom d’hôte de votre service sur la page de détails du service (par ex. abc123.us-east-1.aws.clickhouse.cloud). Copiez-le avec vos identifiants : vous en aurez besoin pour toutes les étapes restantes et dans les prochains guides de démarrage rapide.
Comprendre les protocoles de connexion
ClickHouse Cloud expose deux principaux protocoles réseau, chacun sur son propre port :
- Protocole natif (port 9440) - Un protocole binaire utilisé par
clickhouse-client,clickhouse-localet la plupart des pilotes spécifiques à un langage. C’est l’option la plus rapide et elle prend en charge toutes les fonctionnalités de ClickHouse. TLS est requis sur Cloud. - Protocole HTTPS (port 8443) - Une interface basée sur HTTP, utile pour les clients REST,
curl, les outils web et les pilotes qui privilégient HTTP. TLS est également requis sur Cloud.
Les deux protocoles nécessitent un chiffrement TLS lors de la connexion à ClickHouse Cloud : vous ne pouvez pas vous connecter en clair. La plupart des outils gèrent cela automatiquement lorsque vous indiquez le bon port, mais vous devrez peut-être passer l’option --secure ou définir ssl=true selon le client.
Pour la plupart des guides de démarrage rapide et des workflows CLI de cette série, vous utiliserez le protocole natif sur le port 9440.
Enregistrer vos informations de connexion pour les réutiliser
Vous utiliserez souvent ces informations de connexion dans les guides de démarrage rapide. Pour éviter de les ressaisir à chaque fois, vous pouvez les exporter comme variables d’environnement dans votre session de terminal :
export CLICKHOUSE_HOST=YOUR_HOST.clickhouse.cloud
export CLICKHOUSE_USER=default
export CLICKHOUSE_PASSWORD=YOUR_PASSWORDRemplacez les valeurs par votre nom d’hôte, votre nom d’utilisateur et votre mot de passe réels.
Si vous vous connectez à votre service Cloud avec clickhouse-client ou clickhouse-local, obtenez le nom d’hôte en sélectionnant 'Native' dans le menu déroulant à côté de "Connect with:".
Copiez le nom d’hôte qui apparaît après --host dans l’exemple de connexion affiché.
Étapes suivantes
Vous disposez maintenant de toutes les informations de connexion nécessaires pour vous connecter à votre service ClickHouse Cloud depuis n’importe quel outil externe. Le nom d’hôte, le port, le nom d’utilisateur et le mot de passe que vous avez trouvés ici sont utilisés dans la suite de cette série de guides de démarrage rapide.
Consultez ensuite les guides de démarrage rapide suivants :
Ou approfondissez avec la documentation de référence :
