Analytique en temps réelEntrepôt de donnéesObservabilitéIA/MLCloud
Cette page explique comment retrouver les détails de connexion d'un service ClickHouse Cloud existant — hostname, numéros de port, username et mot de passe — depuis la ligne de commande, à l'aide de la [ClickHouse CLI](/fr/products/cloud/features/cli) (`clickhousectl`). Les commandes sont non interactives ; `clickhousectl` produit du JSON avec `--json`.
Prérequis
Installez le ClickHouse CLI :
```bash theme={null}
curl https://clickhouse.com/cli | sh
```
Vous avez également besoin de `jq`.
Les étapes d'écriture ci-dessous nécessitent une [authentification par API key](/fr/products/cloud/features/admin-features/api/openapi) : `cloud service start` (uniquement si votre service est à l'état `stopped`) et `reset-password`. La connexion OAuth est en read-only et ne couvre que les étapes de lecture (`service list`, `service get`) :
```bash theme={null}
clickhousectl cloud auth login --api-key --api-secret
```
Vous pouvez également définir les variables d'environnement `CLICKHOUSE_CLOUD_API_KEY` et `CLICKHOUSE_CLOUD_API_SECRET`. Vérifiez avec `clickhousectl cloud auth status` : une entrée avec le scope `read/write` doit apparaître.
Vous devez également disposer d'un service ClickHouse Cloud existant dont vous pourrez récupérer les détails de connexion, par exemple un service créé dans le quickstart [Créez votre premier service Cloud](/fr/get-started/quickstarts/create-your-first-service-on-cloud) ou via le flux CLI [Quick Start Cloud](/fr/getting-started/quick-start/cloud).
Trouver votre service
Listez les services de votre organisation et notez l'ID de celui auquel vous souhaitez vous connecter :
```bash theme={null}
clickhousectl cloud service list --json | jq -r '.[] | [.id, .name, .state] | @tsv'
```
```text theme={null}
9c2d4e61-7a35-49c8-8f0e-2b5a1d7c3e90 my-first-service running
```
Conservez l'ID du service : toutes les autres commandes de ce guide le prennent en argument. Pour le retrouver par son nom :
```bash theme={null}
CH_ID=$(clickhousectl cloud service list --json | jq -r '.[] | select(.name == "my-first-service") | .id')
```
Le service doit être en cours d'exécution pour pouvoir vérifier la connectivité à une étape ultérieure. Si son state est `stopped`, démarrez-le et interrogez-le jusqu'à ce qu'il passe à `running` (un service `idle` du fait de l'idle scaling se réveille automatiquement à la première connection : aucune action n'est donc nécessaire ici) :
```bash theme={null}
clickhousectl cloud service start "$CH_ID"
while [ "$(clickhousectl cloud service get "$CH_ID" --json | jq -r .state)" != "running" ]; do
sleep 15
done
```
Récupérer vos détails de connexion
`clickhousectl cloud service get` renvoie l'ensemble des détails du service, dont un endpoint par protocole exposé. Enregistrez la réponse et extrayez-en les éléments dont vous avez besoin :
```bash theme={null}
clickhousectl cloud service get "$CH_ID" --json > service.json
jq '.endpoints' service.json
```
```json theme={null}
[
{
"host": "abc123.us-east-1.aws.clickhouse.cloud",
"port": 9440,
"protocol": "nativesecure"
},
{
"host": "abc123.us-east-1.aws.clickhouse.cloud",
"port": 8443,
"protocol": "https"
}
]
```
Voici les deux principaux protocoles réseau de ClickHouse Cloud, chacun sur son propre port :
* **Protocole natif (`nativesecure`, port 9440)** — un protocole binaire utilisé par `clickhouse-client`, `clickhouse-local` et la plupart des drivers propres à un langage. C'est l'option la plus rapide et elle prend en charge toutes les fonctionnalités de ClickHouse. TLS est obligatoire sur Cloud.
* **Protocole HTTPS (`https`, port 8443)** — une interface basée sur HTTP, utile pour les clients REST, `curl`, les outils web et les drivers qui privilégient HTTP. Requiert également TLS sur Cloud.
Les deux protocoles exigent le chiffrement TLS pour se connecter à ClickHouse Cloud : la connexion en plaintext est impossible. La plupart des outils s'en chargent automatiquement dès lors que vous indiquez le bon port, mais il peut être nécessaire de passer un flag `--secure` ou de définir `ssl=true`, selon le client. Pour la plupart des quickstarts et des workflows CLI de cette série, vous utiliserez le **protocole natif sur le port 9440**.
Extrayez le hostname et les ports :
```bash theme={null}
CH_HOST=$(jq -r '.endpoints[] | select(.protocol == "nativesecure") | .host' service.json)
CH_NATIVE_PORT=$(jq -r '.endpoints[] | select(.protocol == "nativesecure") | .port' service.json)
CH_HTTPS_PORT=$(jq -r '.endpoints[] | select(.protocol == "https") | .port' service.json)
```
Le nom d'utilisateur est `default`, sauf si vous avez créé d'autres utilisateurs de base de données.
Obtenir un mot de passe
Le mot de passe de l'utilisateur `default` n'est renvoyé qu'une seule fois, par `clickhousectl cloud service create` — aucun appel d'API ou de CLI ne permet de le récupérer par la suite. Si vous l'avez conservé au moment de la création, affectez-le à la variable utilisée dans les étapes suivantes et passez la réinitialisation :
```bash theme={null}
CH_PASSWORD=''
```
En cas de perte, générez-en un nouveau :
```bash theme={null}
CH_PASSWORD=$(clickhousectl cloud service reset-password "$CH_ID" --json | jq -r .password)
```
`reset-password` invalide immédiatement le mot de passe précédent de l'utilisateur `default` : tout client encore configuré avec l'ancien mot de passe ne parvient plus à s'authentifier. Si le service appartient à un [warehouse](/fr/products/cloud/features/infrastructure/warehouses), les utilisateurs de base de données sont partagés entre tous les services de ce warehouse : la réinitialisation change donc aussi le mot de passe de tous les services associés. Comme le mot de passe initial, le nouveau mot de passe n'est affiché qu'une seule fois : conservez-le en lieu sûr.
Enregistrez vos détails de connexion pour les réutiliser
Vous utiliserez fréquemment ces détails de connexion tout au long des quickstarts. Pour éviter de les ressaisir à chaque fois, vous pouvez les exporter sous forme de variables d'environnement dans votre session de terminal :
```bash theme={null}
export CLICKHOUSE_HOST=$CH_HOST
export CLICKHOUSE_USER=default
export CLICKHOUSE_PASSWORD=$CH_PASSWORD
```
Ces variables d'environnement ne persistent que le temps de votre session de terminal en cours. Ne stockez pas de mots de passe dans les fichiers de profil du shell (`.bashrc`, `.zshrc`) et ne les intégrez pas à un système de contrôle de version.
Vérifier la connectivité
Vérifiez l'interface HTTPS (port 8443) avec `curl` :
```bash theme={null}
curl --user "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" \
"https://$CLICKHOUSE_HOST:8443/?query=SELECT%201"
```
```text theme={null}
1
```
Vérifiez le protocole natif (port 9440) avec [**clickhouse client**](/fr/concepts/features/interfaces/client). Le ClickHouse CLI gère le binaire `clickhouse` pour vous : si vous ne l'avez pas encore, `clickhousectl local use latest` l'installe et crée un lien symbolique vers `~/.local/bin/clickhouse`. Ensuite :
```bash theme={null}
clickhouse client --host "$CLICKHOUSE_HOST" --secure --port 9440 \
--user "$CLICKHOUSE_USER" --password "$CLICKHOUSE_PASSWORD" \
--query "SELECT concat('Connected to ClickHouse ', version(), ' as ', currentUser())"
```
```text theme={null}
Connected to ClickHouse 26.2.1.558 as default
```
Nettoyage
Ce guide se contente de lire les metadata du service et (éventuellement) de réinitialiser un mot de passe — il ne crée aucune nouvelle cloud resource, il n'y a donc rien à nettoyer.
Une exception : si votre service était `stopped` et que vous l'avez démarré uniquement pour vérifier la connectivité, il reste désormais actif et le compute est facturé. Arrêtez-le de nouveau si vous n'avez pas encore besoin qu'il soit en cours d'exécution :
```bash theme={null}
clickhousectl cloud service stop "$CH_ID"
```
Prochaines étapes
Vous disposez désormais de tous les détails de connexion nécessaires pour vous connecter à votre service ClickHouse Cloud depuis n'importe quel outil externe. Le hostname, le port, le username et le mot de passe que vous avez relevés ici sont utilisés tout au long des autres quickstarts de la série.
Poursuivez avec les quickstarts suivants :
* [Insérer des données avec clickhouse-client](/fr/get-started/quickstarts/insert-data-using-clickhouse-client)
* [Créer votre première table MergeTree](/fr/get-started/quickstarts/create-your-first-mergetree-table)
Ou approfondissez le sujet avec la documentation de référence :
* [Interface native (TCP)](/fr/concepts/features/interfaces/tcp)
* [Interface HTTP](/fr/concepts/features/interfaces/http)