Zum Inhalt springen

ClickHouse-Client

Führe analytische Abfragen über HTTP aus, lies Pläne und Pipelines und verwalte Parts und Partitionen von MergeTree.

Auf einen Blick

Abfragesprache
SQL
Treiber
In der Mac-App enthalten
Verbinden über
Host und Port, SSH-Tunnel, SSL/TLS
Standardport
8123
Mindestversion
Keine
TablePro auf einem Mac, verbunden mit ClickHouse, mit einer Analyseabfrage und ihren Ergebnissen.

Verbinden

Gib Host, HTTP-Port, Benutzer und optional eine Datenbank ein und wechsle Datenbanken ohne Neuverbinden; offene Tabs behalten die Datenbank, mit der sie gestartet sind.

Jeder SSL-Modus schaltet die Verbindung auf HTTPS um. Port 443 oder 8443, den ClickHouse Cloud nutzt, aktiviert Verify Identity, das das Zertifikat gegen deine CA-Datei oder den System-Vertrauensspeicher prüft. Verify CA braucht eine CA-Datei, und Client-Zertifikat und Schlüssel erreichen Server, die gegenseitiges TLS verlangen.

Erreiche einen entfernten Server ohne TLS über einen SSH-Tunnel, statt unverschlüsseltes HTTP über das Netzwerk zu senden.

Abfragen und bearbeiten

Das Explain-Menü bietet Plan, Pipeline, AST, Syntax und Estimate. Die eingerückte Ausgabe wird als Diagramm oder Baum dargestellt, und Estimate zeigt die Zeilen, Marks und Parts, die eine Abfrage lesen würde. Eine laufende Abfrage zeigt die bisher gelesenen Zeilen, Stop sendet KILL QUERY, und das Abfragezeitlimit der Verbindung wird an den Server weitergegeben.

Inserts sowie UPDATE- und DELETE-Mutationen laufen aus dem Raster. Erfolgreiches Speichern bedeutet angenommen, nicht angewendet: Verfolge den Fortschritt in system.mutations. Materialisierte Views sind schreibgeschützt. Punkt- und Ring-Tupel öffnen sich in der Kartenansicht, und eine Abfrage mit eigener FORMAT-Klausel zeigt die rohe Serverausgabe in einer Spalte; lass die Klausel daher weg, um ein Raster zu bekommen.

Tabellen, Parts und Überwachung

Eine Tabelle öffnet sich mit den Tabs Structure, Indexes, DDL und Parts. Indexes zeigt den Sortierschlüssel und Data-Skipping-Indizes, DDL das vollständige CREATE TABLE samt Engine und Einstellungen, und Parts liest system.parts, mit Optimize, Drop Partition und Detach Partition. Der Structure-Tab ändert Spalten und entfernt Data-Skipping-Indizes. Sortier- und Primärschlüssel werden beim Erstellen der Tabelle festgelegt; füge daher einen Data-Skipping-Index mit ALTER TABLE … ADD INDEX hinzu und erstelle die Tabelle für andere Änderungen neu.

Das Server Dashboard zeigt aktive Abfragen, Merges, Part-Mutationen und Datenträgernutzung, beendet andere Sitzungen und listet aus system.query_log abgeschlossene Abfragen, die länger als eine Sekunde dauerten.

Diese Seite behandelt, was speziell für ClickHouse gilt. Safe Mode, der KI-Assistent, der MCP-Server und der Rest von TablePro stehen auf den Funktionsseiten.

Außerdem

  • Daten übertragen

    Importiere CSV, TSV, JSON, JSONL, XLSX und SQL-Dateien und exportiere Tabellen oder Ergebnisse als CSV, JSON, SQL, XLSX, Markdown, HTML und XML. Eine Spalte mit auch nur einem ungültigen UTF-8-Wert erscheint als Hex; wähle toValidUTF8(column), um sie als Text zu lesen.

  • Grenzen

    • Verbindungen nutzen die HTTP-Schnittstelle von ClickHouse. Das native TCP-Protokoll wird nicht verwendet.
    • TLS ist standardmäßig aus. Wähle im Verbindungsformular einen SSL-Modus für HTTPS.
    • Keine Fremdschlüssel und keine Transaktionen.
    • Eine SET-Anweisung wirkt nicht in der nächsten Abfrage weiter.
  • Wie ändere ich eine Einstellung für eine Abfrage?

    Setze sie in eine SETTINGS-Klausel der Abfrage, etwa SELECT … SETTINGS max_threads = 4. Jede Anweisung ist eine eigene HTTP-Anfrage, daher ist ein separates SET bei der nächsten wieder weg.

  • Warum verbindet sich Port 9000 nicht?

    Port 9000 ist der native TCP-Port von ClickHouse, den TablePro nicht nutzt. Verbinde dich mit dem HTTP-Port oder mit 8443 für HTTPS bei ClickHouse Cloud; eine Anfrage an /ping auf diesem Port antwortet mit Ok., wenn die HTTP-Schnittstelle aktiviert ist.

TablePro herunterladen

Alles auf dieser Seite ist kostenlos.