ClickHouse avec clickhousectl
clickhousectl gère ClickHouse dans deux environnements :
- Local — ClickHouse installé et exécuté sur la machine de l'utilisateur, pour le développement.
- Cloud — services ClickHouse Cloud gérés, pour la production : entièrement gérés, scaling automatique, sauvegardes et mises à jour.
Ce fichier oriente vers la bonne référence. Les workflows étape par étape se trouvent dans ref/local.md et ref/cloud.md — consultez celui qui correspond à la situation de l'utilisateur avant d'exécuter les commandes.
Quelle référence utiliser
| L'utilisateur veut... | Consulter |
|---|---|
| Construire une app avec ClickHouse, développer ou prototyper localement, aucun compte cloud nécessaire | ref/local.md |
| Passer en production, héberger une ClickHouse gérée, ou utiliser ClickHouse Cloud explicitement | ref/cloud.md |
| Opérer un service cloud existant (schémas, utilisateurs, requêtes contre celui-ci) | ref/cloud.md |
| Développer localement maintenant, déployer en production plus tard | Commencez par ref/local.md ; il pointe vers ref/cloud.md quand il est temps de passer à la prod |
Si c'est vraiment ambigu (par exemple « configurer ClickHouse pour mon app »), privilégiez le local pour les tâches de développement et demandez confirmation avant de créer quoi que ce soit dans le cloud — les services cloud coûtent de l'argent.
Prérequis (les deux workflows)
Vérifiez que clickhousectl est installé :
which clickhousectlS'il n'est pas trouvé, installez-le :
curl -fsSL https://clickhouse.com/cli | shCela installe dans ~/.local/bin/clickhousectl (avec un alias chctl). Si la commande n'est toujours pas trouvée, suggérez export PATH="$HOME/.local/bin:$PATH" ou un nouveau terminal.
Toutes les commandes acceptent --json pour une sortie lisible par machine. Les codes de sortie suivent les conventions de gh : 0 succès, 1 erreur, 2 annulé, 4 authentification requise.
Liens connexes
- Pour concevoir des schémas, consultez la skill
clickhouse-best-practicespour la sélection ORDER BY, les types de données et le partitioning. - Pour Postgres (développement local ou ClickHouse Cloud Postgres géré), utilisez la skill
infra-postgres.