Client ClickHouse pour Mac
Exécutez du SQL analytique via l’interface HTTP de ClickHouse, lisez le plan, le pipeline ou l’estimation de lignes d’une requête et gérez les parts et partitions MergeTree depuis l’onglet Parts. Les longues requêtes indiquent les lignes lues pendant l’exécution et Arrêter les termine sur le serveur.
Fonctionne sur MacPilote intégré à l’app Mac


En bref
- Langage de requête
- SQL
- Pilote
- Intégré à l’app Mac
- Connexion via
- Hôte et port, Tunnel SSH, SSL/TLS
- Port par défaut
- 8123
- iPhone et iPad
- Ne s’ouvre pas
Connexion
Indiquez l’hôte et le port HTTP, un utilisateur et, si vous le souhaitez, une base de données. Le changement de base s’effectue sur place et un onglet ouvert conserve sa base initiale. Présentation > Barre latérale en arborescence affiche les bases du serveur dans une arborescence à développer sur place.
Choisissez un mode SSL pour passer à HTTPS. Un port 443 ou 8443, ce dernier utilisé par ClickHouse Cloud, active Vérifier l’identité, qui contrôle le certificat avec votre fichier d’AC ou le magasin de confiance du système. Vérifier l’AC nécessite un fichier d’AC ; un certificat client et sa clé permettent d’accéder aux serveurs exigeant TLS mutuel.
Sans TLS, accédez à un serveur distant via un tunnel SSH plutôt que d’envoyer du HTTP en clair sur le réseau.
Interrogez et modifiez
Chaque requête porte son propre ID et demande des informations de progression ; une longue requête indique ainsi les lignes lues. Arrêter envoie KILL QUERY pour cet ID et le délai de requête de la connexion est transmis au serveur.
Le menu Expliquer propose Plan, Pipeline, AST, Syntaxe et Estimation. La sortie indentée est représentée en diagramme ou en arbre ; Estimation affiche les lignes, marks et parts que la requête lirait.
Les modifications de la grille partent comme INSERT, ALTER TABLE … UPDATE et ALTER TABLE … DELETE, précédées d’un Aperçu SQL. ClickHouse effectue mises à jour et suppressions comme mutations en arrière-plan : enregistrer signifie donc accepté, pas encore appliqué ; system.mutations montre la progression. Une vue matérialisée s’ouvre en lecture seule.
Un résultat contenant des tuples de points ou d’anneaux ClickHouse s’ouvre dans la vue Carte. Une requête avec sa propre clause FORMAT affiche la sortie brute du serveur dans une colonne ; omettez cette clause pour obtenir une grille.
Tables, parts et partitions
Une table s’ouvre avec les onglets Structure, Index, DDL et Parts. Index affiche la clé de tri et les index de saut de données ; DDL montre le CREATE TABLE complet, moteur et paramètres compris.
Parts répertorie chaque part de system.parts avec sa partition, ses lignes, sa taille sur disque, sa date de modification et son indicateur d’activité, puis permet d’exécuter Optimiser, Supprimer la partition et Détacher la partition.
L’onglet Structure ajoute, modifie et supprime des colonnes et supprime les index de saut de données. La clé de tri et la clé primaire sont fixées à la création ; ajoutez donc un index de saut avec ALTER TABLE … ADD INDEX et recréez la table pour les autres changements.
Surveiller
Le Tableau de bord serveur affiche les requêtes et fusions actives, les mutations de parts et l’utilisation disque, liste les autres sessions avec Terminer la session et lit les requêtes lentes dans system.query_log : les dernières requêtes terminées ayant duré plus d’une seconde.
Transférez des données
Chargez des fichiers CSV, TSV, JSON, JSONL, XLSX et SQL avec Importer et exportez tables ou résultats de requête en CSV, JSON, SQL, XLSX, Markdown, HTML et XML. Une colonne contenant ne serait-ce qu’une valeur UTF-8 invalide s’affiche en hexadécimal dans la grille ; sélectionnez toValidUTF8(column) pour la lire en texte.
iPhone et iPad
L’app iPhone et iPad n’a pas de pilote ClickHouse. Les connexions ClickHouse synchronisées depuis un Mac apparaissent dans sa liste, mais ne s’ouvrent pas.
Limites
- Les connexions utilisent l’interface HTTP de ClickHouse, pas le protocole TCP natif.
- TLS est désactivé par défaut. Choisissez un mode SSL dans le formulaire pour utiliser HTTPS.
- Aucune clé étrangère ni transaction.
- Une instruction SET ne persiste pas dans la requête suivante.
Questions sur ClickHouse
Comment modifier un paramètre pour une seule requête ?
Placez-le dans une clause SETTINGS de la requête elle-même, par exemple SELECT … SETTINGS max_threads = 4. Chaque instruction est sa propre requête HTTP sans session ; un SET séparé ne subsiste donc pas à la suivante.
Pourquoi le port 9000 ne se connecte-t-il pas ?
Le port 9000 est le port TCP natif de ClickHouse, que TablePro n’utilise pas. Connectez-vous au port HTTP, ou au 8443 pour HTTPS sur ClickHouse Cloud, et vérifiez que l’interface HTTP est active : une requête à /ping sur ce port répond Ok.
Obtenir TablePro
Nécessite macOS 13 Ventura ou version ultérieure