Postgres avec clickhousectl
clickhousectl gère Postgres dans deux environnements :
- Local — instances Postgres nommées, sauvegardées par Docker sur la machine de l'utilisateur, pour le développement.
- Cloud — services Postgres gérés dans ClickHouse Cloud (bêta), pour la production : HA, réplicas en lecture, restauration à un moment donné.
Ce fichier oriente vers la bonne référence. Les workflows pas à pas se trouvent dans ref/local.md et ref/cloud.md — lire celui qui correspond à la situation de l'utilisateur avant d'exécuter les commandes.
Quelle référence utiliser
| L'utilisateur souhaite… | Lire |
|---|---|
| Développer ou prototyper localement, exécuter des tests/CI contre Postgres, pas de compte cloud nécessaire | ref/local.md |
| Passer en production, héberger un Postgres géré, ou utiliser explicitement ClickHouse Cloud | ref/cloud.md |
| Exploiter un service cloud existant (mots de passe, TLS, configuration, réplicas, basculement, restauration) | ref/cloud.md |
| Développer localement maintenant, déployer en production plus tard | Commencer par ref/local.md ; il pointe vers ref/cloud.md quand il est temps de passer à la prod |
Si c'est véritablement ambigu (par ex. « configurer Postgres pour mon application »), par défaut local pour les tâches de développement et demander 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érifier que clickhousectl est installé :
which clickhousectlS'il n'est pas trouvé, l'installer :
curl -fsSL https://clickhouse.com/cli | shCeci installe dans ~/.local/bin/clickhousectl (avec un alias chctl). Si la commande n'est toujours pas trouvée, suggérer 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.
Connexes
- Pour répliquer les données Postgres dans ClickHouse à des fins d'analytics, voir ClickPipes (
clickhousectl cloud clickpipe --help). - Pour ClickHouse lui-même (développement local ou services ClickHouse Cloud), utiliser la skill
infra-clickhouse.