Aller au contenu

Client ClickHouse

Exécutez des requêtes analytiques via HTTP, lisez plans et pipelines, et gérez les parts et partitions MergeTree.

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
Version minimale
Aucune
TablePro sur Mac, connecté à ClickHouse, avec une requête analytique et ses résultats.

Connexion

Saisissez l’hôte, le port HTTP, l’utilisateur et, si besoin, une base, et changez de base sans reconnexion ; les onglets ouverts gardent leur base initiale.

Tout mode SSL fait passer la connexion en HTTPS. Un port 443 ou 8443, celui qu’utilise ClickHouse Cloud, active Verify Identity, qui contrôle le certificat avec votre fichier d’AC ou le magasin de confiance du système. Verify CA nécessite un fichier d’AC, et un certificat client et sa clé permettent d’accéder aux serveurs qui exigent 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

Le menu Explain propose Plan, Pipeline, AST, Syntax et Estimate. La sortie indentée est représentée en diagramme ou en arbre, et Estimate affiche les lignes, marks et parts qu’une requête lirait. Une requête en cours affiche les lignes déjà lues, Stop envoie KILL QUERY, et le délai de requête de la connexion est transmis au serveur.

Les insertions et les mutations UPDATE et DELETE s’exécutent depuis la grille. Un enregistrement réussi signifie accepté, pas appliqué : suivez la progression dans system.mutations. Les vues matérialisées sont en lecture seule. Les tuples de points et d’anneaux s’ouvrent dans la vue Carte, et une requête avec sa propre clause FORMAT affiche la sortie brute du serveur dans une colonne ; omettez donc cette clause pour obtenir une grille.

Tables, parts et surveillance

Une table s’ouvre avec les onglets Structure, Indexes, DDL et Parts. Indexes affiche la clé de tri et les index de saut de données, DDL le CREATE TABLE complet avec moteur et paramètres, et Parts lit system.parts, avec Optimize, Drop Partition et Detach Partition. L’onglet Structure modifie les colonnes et supprime les index de saut de données. La clé de tri et la clé primaire sont fixées à la création de la table ; ajoutez donc un index de saut avec ALTER TABLE … ADD INDEX et recréez la table pour les autres changements.

Server Dashboard affiche les requêtes actives, les fusions, les mutations de parts et l’utilisation disque, met fin aux autres sessions et liste, depuis system.query_log, les requêtes terminées ayant duré plus d’une seconde.

Cette page présente ce qui est propre à ClickHouse. Safe Mode, l’assistant IA, le serveur MCP et le reste de TablePro sont décrits dans les pages des fonctionnalités.

Et aussi

  • Déplacer les données

    Importez des fichiers CSV, TSV, JSON, JSONL, XLSX et SQL, et exportez tables ou résultats 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 ; sélectionnez toValidUTF8(column) pour la lire en texte.

  • 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.
  • Comment modifier un paramètre pour une seule requête ?

    Placez-le dans une clause SETTINGS de la requête, par exemple SELECT … SETTINGS max_threads = 4. Chaque instruction est sa propre requête HTTP ; un SET séparé a donc disparu à 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 ; une requête à /ping sur ce port répond Ok. quand l’interface HTTP est active.

Obtenez TablePro

Tout ce qui figure sur cette page est gratuit.